Unichat MCP 服务器（Python 版）

同样也有 TypeScript 版本可用。

使用 MCP 协议通过工具或预定义提示向 OpenAI、MistralAI、Anthropic、xAI 或 Google AI 发送请求。需要 vendor API 密钥。

工具

服务器实现了一个工具：

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

提示

• code_review
  • 审查代码的最佳实践、潜在问题和改进
  • 参数：
    • code (string, required): 要审查的代码"
• document_code
  • 为代码生成文档，包括 docstrings 和注释
  • 参数：
    • code (string, required): 要注释的代码"
• explain_code
  • 详细解释一段代码的工作原理
  • 参数：
    • code (string, required): 要解释的代码"
• code_rework
  • 应用请求的更改到提供的代码
  • 参数：
    • changes (string, optional): 要应用的更改"
    • code (string, required): 要重写的代码"

快速开始

安装

Claude Desktop

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

支持的模型：

可用于 "SELECTED_UNICHAT_MODEL" 的当前支持模型列表可在此处找到 这里。请确保添加相关的 vendor 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 Desktop 安装 Unichat：

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

开发

构建和发布

要准备分发包：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建包分布：

uv build

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

3. 发布到 PyPI：

uv publish --token {{YOUR_PYPI_API_TOKEN}}

调试

由于 MCP 服务器通过 stdio 运行，调试可能会很困难。要开始调试：

• 在终端中运行以下命令：

  uvicorn unichat.mcp_server:app --reload
  

• 打开 http://localhost:8000 访问文档

Inspector 将在控制台中显示一个 URL，您可以在浏览器中访问该 URL 开始调试。