API代理服务器

Mist MCP Server是一个生产级的MCP服务器,通过mistapi包装Mist API,使Cursor和VS Code等AI工具能够通过标准MCP工具安全调用Mist服务。

  • by rolfsormo
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rolfsormo/mist-mcp-server

使用说明

薄雾MCP服务器

无需编写代码,即可从您的AI工具可靠访问Juniper Mist。

该项目提供了一个生产级MCP服务器,通过 mistapi,因此Cursor和VS Code可以通过标准MCP安全地调用Mist 工具。

为什么存在

MCP服务器使API访问对于AI工具来说简单且一致。此服务器 集中连接和身份验证,在启动时验证配置,以及 公开了一个工具注册表,因此非程序员可以通过自然语言使用Mist。

先决条件

  • Python 3.10+
  • Mist API代币

安装

终端用户无需手动安装。MCP跑步者引导当地人 虚拟环境首次运行。

配置

创建一个 .env 此文件夹中的文件(请参见 mist.env.example):

MIST_API_TOKEN=your_token_here
MIST_API_HOST=https://api.mist.com
MIST_API_TIMEOUT_SECONDS=30

重要提示: MIST_API_HOST 必须是基本主机(否 /api/v1).服务器 将在启动时调用Mist“self”端点,如果主机 或令牌无效。

本地使用(光标)

  1. 在Cursor中打开此项目。
  2. 确保a mcp.json 文件存在于 .cursor/mcp.json。此回购已 提供它,所以你通常不需要改变任何东西。
  3. 使用以下配置:
{
  "mcpServers": {
    "mist": {
      "command": "${workspaceFolder}/run-mcp.sh",
      "args": [],
      "envFile": "${workspaceFolder}/.env",
      "transport": "stdio"
    }
  }
}
  1. 重新启动光标(或重新加载窗口)。
  2. 让Cursor调用Mist工具,例如“列出我的组织”。

本地使用(VS代码)

  1. 在VS Code中打开此项目。
  2. 确保a mcp.json 文件存在于 .vscode/mcp.json。此回购已 提供它,所以你通常不需要改变任何东西。
  3. 重新加载窗口并使用MCP客户端调用Mist工具。

用法

  • 工具注册表由Mist SDK生成。
  • 使用 mist_search_tools 按关键字查找工具。
  • 使用 mist_list_groups 发现工具组并过滤搜索。
  • 使用 mist_list_methods 列出组中的方法。
  • 使用 mist_describe_tool 查看参数和详细信息。
  • 使用 mist_call_tool 使用args/kwargs按名称执行。
  • SDK更新后,通过以下方式重新生成注册表 scripts/generate_tools.py.

由Hamina赞助

在哈米纳工作期间建造。

发展

pip install -e ".[dev]"
./.venv/bin/python scripts/generate_tools.py
pytest
ruff check .
ruff format .
mypy src

贡献

我们欢迎优秀的公关。看 CONTRIBUTING.md 作为指导方针。

许可证

阿帕奇-2.0。看 LICENSE.