Python 版 Unichat MCP 服务器

也可使用 TypeScript 版本

通过 MCP 协议向 OpenAI、MistralAI、Anthropic、xAI、Google AI、DeepSeek、阿里巴巴、Inception 发送请求，使用工具或预定义提示。 需要供应商 API 密钥

工具

服务器实现了一个工具：

• unichat：向 unichat 发送请求
  • 需要 "messages" 作为必需的字符串参数
  • 返回响应

提示

• code_review
  • 审查代码以发现最佳实践、潜在问题和改进建议
  • 参数：
    • code（字符串，必需）：要审查的代码"
• document_code
  • 为代码生成文档，包括文档字符串和注释
  • 参数：
    • code（字符串，必需）：要注释的代码"
• explain_code
  • 详细解释代码的工作原理
  • 参数：
    • code（字符串，必需）：要解释的代码"
• code_rework
  • 对提供的代码应用请求的更改
  • 参数：
    • changes（字符串，可选）：要应用的更改"
    • code（字符串，必需）：要修改的代码"

快速开始

安装

Claude 桌面版

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

支持的模型：

当前支持的模型列表，可用作 "SELECTED_UNICHAT_MODEL"，请参见此处。请确保添加相关的供应商 API 密钥作为 "YOUR_UNICHAT_API_KEY"

示例：

"env": {
  "UNICHAT_MODEL": "gpt-4o-mini",
  "UNICHAT_API_KEY": "YOUR_OPENAI_API_KEY"
}

开发/未发布服务器配置

"mcpServers": {
  "unichat-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "{{your source code local directory}}/unichat-mcp-server",
      "run",
      "unichat-mcp-server"
    ],
    "env": {
      "UNICHAT_MODEL": "SELECTED_UNICHAT_MODEL",
      "UNICHAT_API_KEY": "YOUR_UNICHAT_API_KEY"
    }
  }
}

已发布服务器配置

"mcpServers": {
  "unichat-mcp-server": {
    "command": "uvx",
    "args": [
      "unichat-mcp-server"
    ],
    "env": {
      "UNICHAT_MODEL": "SELECTED_UNICHAT_MODEL",
      "UNICHAT_API_KEY": "YOUR_UNICHAT_API_KEY"
    }
  }
}

通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面版安装 Unichat：

npx -y @smithery/cli install unichat-mcp-server --client claude

开发

构建和发布

准备分发包：

1. 删除旧构建：

rm -rf dist

2. 同步依赖并更新锁文件：

uv sync

3. 构建包分发：

uv build

这将在 dist/ 目录中创建源代码和 wheel 分发。

4. 发布到 PyPI：

uv publish --token {{YOUR_PYPI_API_TOKEN}}

调试

由于 MCP 服务器通过 stdio 运行，调试可能会有些困难。为了获得最佳的调试体验，我们强烈推荐使用 MCP Inspector。

你可以通过 npm 使用以下命令启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory {{your source code local directory}}/unichat-mcp-server run unichat-mcp-server

启动后，Inspector 将显示一个 URL，你可以在浏览器中访问该 URL 开始调试。