Unichat MCP Server in TypeScript

也可在 Python 中使用

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

通过参数支持 STDIO 和 SSE 传输机制。

工具

服务器实现了一个工具：

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

提示

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

开发

安装依赖：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

运行评估

评估包加载一个 mcp 客户端，然后运行 index.ts 文件，因此在测试之间无需重新构建。你可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可在 这里 找到。

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/server.ts

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Unichat MCP Server：

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

手动安装

要与 Claude Desktop 一起使用，请添加服务器配置：

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

本地运行：

{
  "mcpServers": {
    "unichat-ts-mcp-server": {
      "command": "node",
      "args": [
        "{{/path/to}}/unichat-ts-mcp-server/build/index.js"
      ],
      "env": {
        "UNICHAT_MODEL": "YOUR_PREFERRED_MODEL_NAME",
        "UNICHAT_API_KEY": "YOUR_VENDOR_API_KEY"
      }
    }
}

发布运行：

{
  "mcpServers": {
    "unichat-ts-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "unichat-ts-mcp-server"
      ],
      "env": {
        "UNICHAT_MODEL": "YOUR_PREFERRED_MODEL_NAME",
        "UNICHAT_API_KEY": "YOUR_VENDOR_API_KEY"
      }
    }
}

默认情况下以 STDIO 运行，或使用参数 --stdio。要以 SSE 运行，请添加参数 --sse

npx -y unichat-ts-mcp-server --sse

支持的模型：

当前支持的模型列表，可用作 "YOUR_PREFERRED_MODEL_NAME"，可在 这里 找到。请确保添加相关的供应商 API 密钥作为 "YOUR_VENDOR_API_KEY"

示例：

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

调试

由于 MCP 服务器通过 stdio 通信，调试可能会很困难。我们推荐使用 MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector 将提供一个 URL，以便在浏览器中访问调试工具。

如果在 SSE 模式下测试时遇到超时，请在 inspector 界面上将请求 URL 更改为：http://localhost:3001/sse?timeout=600000