Storm MCP Server 使用说明

项目简介

Storm MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它充当 LLM 应用（如 Claude Desktop）和 Sionic AI Storm Platform 之间的桥梁。通过 MCP 协议，Storm MCP Server 能够向 LLM 应用提供来自 Storm Platform 的数据资源和工具能力，实现更强大的上下文感知和功能扩展。

主要功能点

上下文共享: 为 LLM 提供访问外部数据源的标准化协议，增强 LLM 的上下文理解能力。
工具系统: 提供了一系列预定义的工具，如 'send_nonstream_chat'（发送非流式聊天请求）、'list_agents'（列出代理）、'list_buckets'（列出存储桶）、'upload_document_by_file'（上传文件）等，允许 LLM 调用 Storm Platform 的功能。
文件管理: 支持文件上传、读取和管理，允许 LLM 应用操作服务器端的文件系统。
Storm Platform 集成: 深度集成 Sionic AI 的 Storm Platform，利用 Storm Platform 强大的 embedding 模型和向量数据库能力，构建 RAG (Retrieval-Augmented Generation) 应用。

安装步骤

克隆仓库

git clone https://github.com/sionic-ai/storm-mcp-server
cd storm-mcp-server

配置 API Key 复制仓库后，编辑 'scripts/run.sh' 文件，在 'export STORM_API_KEY=''' 行中填入您的 Sionic Storm Platform API Key。您需要在 Sionic Storm Platform 注册并获取 API Key。

export STORM_API_KEY='YOUR_API_KEY'  # 将 YOUR_API_KEY 替换为您的实际 API Key

运行服务器 在仓库根目录下，执行 'scripts/run.sh' 脚本启动 MCP 服务器。
```
sh scripts/run.sh
```
服务器默认通过标准输入/输出 (stdio) 与 MCP 客户端通信。

服务器配置 (Claude Desktop 客户端)

要将 Storm MCP Server 连接到 Claude Desktop，您需要修改 Claude Desktop 的配置文件 'claude_desktop_config.json'。

打开配置文件 在终端中运行以下命令打开配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

如果您的配置文件路径不同，请根据实际情况调整。

添加 MCP 服务器配置 在 'claude_desktop_config.json' 文件中，找到 'mcpServers' 字段（如果不存在则创建），并添加以下 JSON 配置：

{
  "mcpServers": {
    "storm": {  // 服务器名称，可以自定义，例如 "storm"
      "command": "sh",  // 启动服务器的命令，这里使用 sh 脚本
      "args": [
        "/path/to/storm-mcp-server/scripts/run.sh" //  'run.sh' 脚本的绝对路径，请替换为您的实际路径
      ]
    }
  }
}

注意:

请将 '/path/to/storm-mcp-server/scripts/run.sh' 替换为 'run.sh' 脚本在您本地文件系统中的绝对路径。您可以使用 'pwd' 命令在仓库根目录查看当前路径，然后拼接上 'scripts/run.sh'。
'"storm"' 是您为该 MCP 服务器定义的名称，在 Claude Desktop 中用于标识和选择该服务器。您可以自定义服务器名称。
'command' 和 'args' 字段告诉 Claude Desktop 如何启动您的 MCP 服务器。

重启 Claude Desktop 保存 'claude_desktop_config.json' 文件并重启 Claude Desktop 应用，配置即可生效。

基本使用方法

连接 MCP 服务器 在 Claude Desktop 中，打开设置或配置界面（通常在 "Preferences" 或 "Settings" 中）。在 MCP 服务器配置部分，您应该能看到名为 "storm" (或您在配置文件中设置的名称) 的服务器。确保该服务器已启用或连接。
使用工具 连接成功后，您可以在 Claude Desktop 中通过自然语言指令调用 Storm MCP Server 提供的工具。例如，您可以要求 Claude 执行以下操作：
- “使用 'send_nonstream_chat' 工具提问...” (具体问题内容)
- “列出我的代理 (使用 'list_agents' 工具)”
- “在 agent_id 为 [your_agent_id] 的代理下列出存储桶 (使用 'list_buckets' 工具)”
- “上传本地文件 [文件路径] 到 bucket_id 为 [your_bucket_id] 的存储桶 (使用 'upload_document_by_file' 工具)”
具体的工具名称和参数，请参考 'tools/tool_definitions.py' 文件中的定义和工具描述。