Mist MCP Server
使用说明
- 项目简介 Mist MCP Server 是一个完整的后端服务实现，按照 Model Context Protocol（MCP）规范提供上下文资源、工具注册与执行、以及可定制的 Prompt 模板渲染能力，面向大型语言模型（LLM）应用，帮助将外部系统的资源与功能暴露给 LLM 客户端。
- 主要功能点
- 资源管理：以标准化方式托管和提供数据资源（Resources），支持 LLM 客户端按需访问。
- 工具注册与执行：注册并暴露 Tools，LLM 可以调用外部功能实现复杂任务。
- Prompt 模板支持：定义、渲染和渲染输出来驱动与 LLM 的交互模式。
- 多传输协议支持：STDIO、HTTP 等传输模式，便于本地或远端部署与对接。
- 会话管理与能力声明：服务器维护会话信息，暴露自身能力。
- 安装步骤
- 确保环境满足要求（Python 3.10+），并安装依赖。
- 下载并进入项目根目录。
- 使用合适的包管理/构建方式安装依赖（示例中常见是通过 setup 或 make 进行初始化）。
- 根据需要选择传输模式（STDIO 或 HTTP），并设置相应环境变量。
- 服务器配置（客户端使用 MCP 服务器所需配置，以下为示例 JSON，描述一个可能的配置，包含 server name、command、args：
{
"mist-mcp": {
"command": "uv",
"args": [
"run",
"mistmcp",
"--mode",
"all"
],
"env": {
"MIST_APITOKEN": "your-api-token",
"MIST_HOST": "api.mist.com"
}
}
}
说明：
- server name: mist-mcp（作为 MCP 客户端在配置中的唯一标识）
- command: uv（启动命令，STDIO 模式常用）
- args: 启动参数，其中 --mode 可以设置为 all（加载全部工具），也可选 managed
- env: 运行所需的环境变量，如 Mist API 令牌与主机 注：若在 Claude Desktop 等客户端的配置中使用，示例还可按需包含 "directory" 路径等，客户端仅需读取上述 JSON 配置以启动对应 MCP 服务器进程。
- 基本使用方法
- 启动服务器：在需要的工作目录执行配置中定义的命令组合（示例中为 STDIO 模式下的 uv run mistmcp --mode all）。
- 客户端接入：将上面的服务器配置提供给 Claude Desktop、VS Code 等 MCP 客户端，通过启动命令将 MCP 服务器接入到对话流程中。
- 运行后在日志中查看服务器启动信息与可用工具摘要，确保工具已按配置加载。