Amidabuddha Unichat MCP Server

🚀 Unichat MCP 服务器（Python 版）

Unichat MCP 服务器（Python 版）可使用 MCP 协议，借助工具或预定义提示向 OpenAI、MistralAI、Anthropic、xAI 或 Google AI 发送请求，不过需要 vendor API 密钥。此外，还有 TypeScript 版本可供使用。

✨ 主要特性

工具

服务器实现了一个工具：

• 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

💻 使用示例

基础用法

以下是在终端中运行服务器的示例：

uvicorn unichat.mcp_server:app --reload

通过上述命令运行服务器后，可打开 http://localhost:8000 访问文档。Inspector 将在控制台中显示一个 URL，您可以在浏览器中访问该 URL 开始调试。

🔧 技术细节

构建和发布

要准备分发包：

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 开始调试。