Sufy MCP Server

基本能力

产品定位

Sufy MCP Server 是一个基于 Sufy 产品的 MCP 服务器，旨在通过 AI 大模型客户端访问 Sufy 服务。

核心功能

• 提供标准输入/输出（stdio）和 SSE（Server-Sent Events）两种传输模式。
• 支持 Sufy 服务的认证和配置，包括访问密钥、区域信息和端点 URL。
• 支持多桶配置，最多可配置 20 个桶。
• 提供扩展功能开发框架，允许用户自定义业务包并注册工具或资源。

适用场景

• 在 AI 大模型客户端中访问 Sufy 服务。
• 开发需要与 Sufy 服务集成的应用程序。
• 测试和调试 Sufy 服务的功能。

工具列表

• Model Control Protocol Inspector：用于测试 MCP 服务器的工具。
• Cline 插件：在 VSCode 中配置和测试 Sufy MCP Server 的工具。

常见问题解答

• 如何安装 UV 包管理器？ bash curl -LsSf https://astral.sh/uv/install.sh | sh
• 如何配置 Sufy 服务的认证信息？ 编辑 .env 文件并设置 SUFY_ACCESS_KEY、SUFY_SECRET_KEY、SUFY_REGION_NAME 和 SUFY_ENDPOINT_URL。

使用教程

使用依赖

• Python 3.12 或更高版本。
• UV 包管理器。

安装 UV 包管理器的命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

1. 克隆仓库：

git clone [email protected]:sufy/sufy-mcp-server.git
cd sufy-mcp-server

1. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows

1. 安装依赖：

uv pip install -e .

调试方式

1. 启动标准输入/输出模式：

uv --directory . run sufy-mcp-server

1. 启动 SSE 模式：

uv --directory . run sufy-mcp-server --transport sse --port 8000

1. 使用 Model Control Protocol Inspector 测试：

npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server

1. 使用 Cline 插件测试：
2. 安装 Cline 插件并配置 MCP Server。
3. 创建聊天窗口与 AI 交互，使用 Sufy MCP Server 的功能。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。