Converse MCP服务器

](https://www.npmjs.com/package/converse-mcp-server)

一个MCP（模型上下文协议）服务器，允许Claude与其他AI模型进行对话。使用它与OpenAI、谷歌、Anthropic、X.AI、Mistral、DeepSeek或OpenRouter的模型聊天。您可以一次与一个模型对话，也可以让多个模型对复杂的决策进行权衡。

📋 需求

Node.js：版本20或更高
包管理器：npm（或pnpm/yarn）
API密钥：至少有一个来自任何受支持的提供商

🚀 快速开始

步骤1：获取API密钥

您至少需要来自以下提供程序的一个API密钥：

提供者	从哪里获取	示例格式
OpenAI	platform.openai.com/api-keys	`sk-proj-...`
谷歌/双子座	makersuit.google.com/app/apikey	`AIzaSy...`
X.AI	console.x.ai	`xai-...`
Anthropic	console.anthropic.com	`sk-ant-...`
米斯特拉尔	安慰.米斯特拉尔.ai	`wfBMkWL0...`
深度求索	platform.depeseek.com	`sk-...`
开放路由	openrouter.ai/keys	`sk-or-...`
法典	ChatGPT登录（系统范围）	本地代理助手

注： Codex使用您的ChatGPT登录（不是API密钥）。如果您有一个活动的ChatGPT会话，Codex将自动工作。对于无头/服务器部署，设置 CODEX_API_KEY 在您的环境中。

步骤2：添加到克劳德代码或克劳德桌面

克劳德代码（推荐）

# Add the server with your API keys
claude mcp add converse \
  -e OPENAI_API_KEY=your_key_here \
  -e GEMINI_API_KEY=your_key_here \
  -e XAI_API_KEY=your_key_here \
  -e ANTHROPIC_API_KEY=your_key_here \
  -e MISTRAL_API_KEY=your_key_here \
  -e DEEPSEEK_API_KEY=your_key_here \
  -e OPENROUTER_API_KEY=your_key_here \
  -e ENABLE_RESPONSE_SUMMARIZATION=true \
  -e SUMMARIZATION_MODEL=gpt-5 \
  -s user \
  npx converse-mcp-server

适用于克劳德桌面

将此配置添加到您的Claude Desktop设置中：

{
  "mcpServers": {
    "converse": {
      "command": "npx",
      "args": ["converse-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "your_key_here",
        "GEMINI_API_KEY": "your_key_here",
        "XAI_API_KEY": "your_key_here",
        "ANTHROPIC_API_KEY": "your_key_here",
        "MISTRAL_API_KEY": "your_key_here",
        "DEEPSEEK_API_KEY": "your_key_here",
        "OPENROUTER_API_KEY": "your_key_here",
        "ENABLE_RESPONSE_SUMMARIZATION": "true",
        "SUMMARIZATION_MODEL": "gpt-5"
      }
    }
  }
}

Windows故障排除：如果 npx converse-mcp-server 在Windows上不起作用，请尝试：

{
  "command": "cmd",
  "args": ["/c", "npx", "converse-mcp-server"],
  "env": {
    "ENABLE_RESPONSE_SUMMARIZATION": "true",
    "SUMMARIZATION_MODEL": "gpt-5"
    // ... add your API keys here
  }
}

第三步：开始使用匡威

安装后，您可以：

与特定模特聊天：让克劳德用聊天工具和你喜欢的模特聊天
达成共识：当你需要多个视角时，让克劳德使用共识工具
在后台运行任务：使用 async: true 对于您稍后可以检查的长时间运行的操作
监督进展：使用check_status工具使用AI生成的摘要监视异步操作
取消作业：使用cancel_job工具停止运行操作
智能摘要：获取自动生成的标题和摘要，以便更好地理解上下文
获取帮助：类型 /converse:help 在克劳德

🛠️ 可用工具

1.聊天工具

与任何支持文件、图像和对话历史的AI模型进行对话。该工具会根据模型名称自动将您的请求路由到正确的提供商。启用AI摘要后，生成智能标题和摘要，以更好地理解上下文。

// Synchronous execution (default)
{
  "prompt": "How should I structure the authentication module for this Express.js API?",
  "model": "gemini-2.5-flash",         // Routes to Google
  "files": ["/path/to/src/auth.js", "/path/to/config.json"],
  "images": ["/path/to/architecture.png"],
  "temperature": 0.5,
  "reasoning_effort": "medium",
  "use_websearch": false
}

// Asynchronous execution (for long-running tasks)
{
  "prompt": "Analyze this large codebase and provide optimization recommendations",
  "model": "gpt-5",
  "files": ["/path/to/large-project"],
  "async": true,           // Enables background processing
  "continuation_id": "my-analysis-task"  // Optional: custom ID for tracking
}

// Codex - Agentic coding assistant with local file access
{
  "prompt": "Analyze this codebase and suggest improvements",
  "model": "codex",
  "files": ["/path/to/your/project"],
  "async": true  // Recommended for Codex (responses take 6-20+ seconds)
}

食品法典注释：

使用基于线程的会话（上下文保持不变 continuation_id)
响应通常需要6-20秒（复杂任务可能需要几分钟）
直接从工作目录访问文件
通过配置沙盒模式 CODEX_SANDBOX_MODE 环境变量

2.共识工具

让多个AI模型同时分析同一个问题。每个模型都可以看到并回应其他模型的答案，从而引发丰富的讨论。

// Synchronous consensus (default)
{
  "prompt": "Should we use microservices or monolith architecture for our e-commerce platform?",
  "models": ["gpt-5", "gemini-2.5-flash", "grok-4"],
  "files": ["/path/to/requirements.md"],
  "enable_cross_feedback": true,
  "temperature": 0.2
}

// Asynchronous consensus (for complex analysis)
{
  "prompt": "Review our system architecture and provide comprehensive recommendations",
  "models": ["gpt-5", "gemini-2.5-pro", "claude-sonnet-4"],
  "files": ["/path/to/architecture-docs"],
  "async": true,          // Run in background
  "enable_cross_feedback": true
}

3.检查状态工具

监控进度并从异步操作中检索结果。启用AI摘要后，提供正在进行和已完成任务的智能摘要。

// Check status of a specific job
{
  "continuation_id": "my-analysis-task"
}

// List recent jobs (shows last 10)
// With summarization enabled, displays titles and final summaries
{}

// Get full conversation history for completed job
{
  "continuation_id": "my-analysis-task",
  "full_history": true
}

4.取消作业工具

需要时取消运行异步操作。

// Cancel a running job
{
  "continuation_id": "my-analysis-task"
}

🤖 AI摘要功能

启用后，服务器会自动生成智能标题和摘要，以更好地理解上下文：

自动生成标题：为每个请求创建描述性标题（最多60个字符）
流媒体摘要：状态检查根据部分流式响应返回最新的进度摘要
最终总结：已完成答复的简明1-2句总结
智能状态显示：增强的check_status工具显示职位列表中的标题和摘要
持久上下文：摘要与异步作业一起存储，以便更好地跟踪进度

配置:

# Enable in your environment
ENABLE_RESPONSE_SUMMARIZATION=true    # Default: false
SUMMARIZATION_MODEL=gpt-5-nano        # Default: gpt-5-nano

益处:

在不阅读完整响应的情况下快速了解每个异步作业正在做什么
在审查多个正在进行的操作时，有更好的背景
通过一目了然地了解任务进度来改进作业管理
当摘要被禁用或失败时，优雅地回退到文本片段

📊 支持的型号

OpenAI模型

gpt-5：最新旗舰型号（400K上下文，128K输出）-卓越的推理、代码生成和分析
gpt-5-mini：更快、更具成本效益的GPT-5（400K上下文，128K输出）-定义明确的任务，精确的提示
gpt-5-nano：最快、最具成本效益的GPT-5（400K上下文，128K输出）-摘要、分类
gpt-5-pro：最先进的推理模型（400K上下文，272K输出）-最难的问题，延长计算时间（昂贵）
臭氧：推理能力强（20万上下文）
o3迷你：快速O3变体（200K上下文）
o3 pro：专业级推理（20万上下文）-非常昂贵
o3深度研究：深度研究模型（200K上下文）-30-90分钟运行时间
o4迷你：最新推理模型（200K上下文）
o4微型深度研究：快速深度研究模型（200K上下文）-15-60分钟运行时间
gpt-4.1：高级推理（1M上下文）
gpt-4o：多模式旗舰（128K上下文）
gpt-4o-mini：快速多模式（128K上下文）

谷歌/双子座模型

API密钥选项:

GEMINI_API_键：适用于Gemini开发人员API（推荐）
GOOGLE_API_键：备选名称（GEMINI_API_KEY优先）
顶点AI：使用 GOOGLE_GENAI_USE_VERTEXAI=true 具有项目/位置设置

支持的型号:

双子座-3-前体综述 （别名： pro, gemini)：增强思维水平的推理能力（1M上下文，64K输出）
双子座-2.5-flash （别名： flash)：超快（1M上下文，65K输出）
双子座-2.5-pro （别名： pro 2.5)：用思维预算进行深入推理（100万上下文，6.5万输出）
双子座2.0闪光：最新实验思维（1M上下文，65K输出）
双子座-2.0-flash-lite：轻量级快速模型，仅文本（1M上下文，65K输出）

备注：默认别名(gemini, pro)现在指向Gemini 3.0 Pro。使用 gemini-2.5-pro 如果你需要2.5版本，请明确说明。

X.AI/Grok模型

格罗克-4-0709 （别名： grok, grok-4)：最新高级型号（256K上下文）
grok-code-fast-1：擅长代理编码的快速经济推理模型（256K上下文）

人类模型

claude-opus-4.1：具有扩展思维的最高智力（20万上下文）
claude-sonnet-4：平衡表现与扩展思维（20万上下文）
claude-3.7连接器：增强3.x代思维能力（20万上下文）
claude-3.5公吨：快速智能（200K上下文）
claude-3.5-haiku：简单查询的最快模型（20万上下文）

西北风模型

魔法媒介：前沿类推理模型（40K上下文）
小魔法师：小型推理模型（40K上下文）
米斯特拉尔中-3：前沿级多模态模型（128K上下文）

DeepSeek模型

deepseek聊天：具有671B/37B参数的强MoE模型（64K上下文）
deepseek推理机：具有CoT的高级推理模型（64K上下文）

OpenRouter型号

qwen3-235b思维：具有增强推理能力的Qwen3（32K上下文）
qwen3编码器：专门用于编程任务（32K上下文）
化学-K2：具有扩展上下文（200K上下文）的Moonshot AI Kimi K2

Codex模型

法典：OpenAI Codex代理编码助理

- 具有持久上下文的基于线程的会话 - 从工作目录直接访问文件系统 - 典型响应时间：6-20秒（复杂任务的响应时间更长） - 需要ChatGPT登录或CODEX_API_KEY - 看配置用于沙盒和审批设置

📚 帮助和文档

内置帮助

直接在Claude中键入这些命令：

/converse:help -完整文档
/converse:help tools -特定于工具的帮助（包括异步功能）
/converse:help models -型号信息
/converse:help parameters -配置详细信息
/converse:help examples -用法示例（同步和异步）
/converse:help async -异步执行指南

额外资源

api参考: docs/API.md文件
架构指南: docs/ARCHITECTURE.md
集成示例: docs/EXAMPLES.md

⚙️ 配置

环境变量

创建一个 .env 项目根目录中的文件：

# Required: At least one API key
OPENAI_API_KEY=sk-proj-your_openai_key_here
GEMINI_API_KEY=your_gemini_api_key_here  # Or GOOGLE_API_KEY (GEMINI_API_KEY takes priority)
XAI_API_KEY=xai-your_xai_key_here
ANTHROPIC_API_KEY=sk-ant-your_anthropic_key_here
MISTRAL_API_KEY=your_mistral_key_here
DEEPSEEK_API_KEY=your_deepseek_key_here
OPENROUTER_API_KEY=sk-or-your_openrouter_key_here

# Optional: Server configuration
PORT=3157
LOG_LEVEL=info

# Optional: AI Summarization (Enhanced async status display)
ENABLE_RESPONSE_SUMMARIZATION=true    # Enable AI-generated titles and summaries
SUMMARIZATION_MODEL=gpt-5-nano        # Model to use for summarization (default: gpt-5-nano)

# Optional: OpenRouter configuration
OPENROUTER_REFERER=https://github.com/FallDownTheSystem/converse
OPENROUTER_TITLE=Converse
OPENROUTER_DYNAMIC_MODELS=true

# Optional: Codex configuration
CODEX_API_KEY=your_codex_api_key_here       # Optional if ChatGPT login available
CODEX_SANDBOX_MODE=read-only                 # read-only (default), workspace-write, danger-full-access
CODEX_SKIP_GIT_CHECK=true                    # true (default), false
CODEX_APPROVAL_POLICY=never                  # never (default), untrusted, on-failure, on-request

配置选项

服务器环境变量（.env文件）

变量	描述	默认值	示例
`PORT`	服务器端口	`3157`	`3157`
`LOG_LEVEL`	日志记录级别	`info`	`debug`, `info`, `error`

Claude代码环境变量（系统/全局）

这些必须在您的系统环境中设置，或者在启动Claude Code时设置，而不是在project.env文件中设置：

变量	描述	默认值	示例
`MAX_MCP_OUTPUT_TOKENS`	令牌响应限制	`25000`	`200000`
`MCP_TOOL_TIMEOUT`	工具执行超时（ms）	`120000`	`5400000` （深度研究90分钟）

# Example: Set globally before starting Claude Code
export MAX_MCP_OUTPUT_TOKENS=200000
export MCP_TOOL_TIMEOUT=5400000  # 90 minutes for deep research models
claude  # Then start Claude Code

模型选择

使用 "auto" 对于自动模型选择，或指定精确的模型：

// Auto-selection (recommended)
"auto";

// Specific models
"gemini-2.5-flash";
"gpt-5";
"grok-4-0709";

// Using aliases
"flash"; // -> gemini-2.5-flash
"pro"; // -> gemini-2.5-pro
"grok"; // -> grok-4-0709
"grok-4"; // -> grok-4-0709

汽车模型行为：

聊天工具：选择第一个可用的提供程序并使用其默认模型
共识工具：使用时 ["auto"]，自动扩展到前3个可用提供商

提供程序优先级顺序（需要相应的API密钥）：

OpenAI(gpt-5)
谷歌gemini-2.5-pro)
XAI(grok-4)
人类学(claude-sonnet-4-20250514)
米斯特拉尔(magistral-medium-2506)
DeepSeek(deepseek-reasoner)
OpenRouter(qwen/qwen3-coder)

系统将使用配置了有效API密钥的前3个提供程序。这实现了自动多模型共识，而无需手动指定模型。

高级配置

手动安装选项

选项A：直接执行Node.js

如果您已在本地克隆了存储库：

{
  "mcpServers": {
    "converse": {
      "command": "node",
      "args": [
        "C:\\Users\\YourUsername\\Documents\\Projects\\converse\\src\\index.js"
      ],
      "env": {
        "OPENAI_API_KEY": "your_key_here",
        "GEMINI_API_KEY": "your_key_here",
        "XAI_API_KEY": "your_key_here",
        "ANTHROPIC_API_KEY": "your_key_here",
        "MISTRAL_API_KEY": "your_key_here",
        "DEEPSEEK_API_KEY": "your_key_here",
        "OPENROUTER_API_KEY": "your_key_here"
      }
    }
  }
}

选项B：本地HTTP开发（高级）

对于使用HTTP传输的本地开发（可选，用于调试）：

首先，使用HTTP传输手动启动服务器:

   # In a terminal, navigate to the project directory
   cd converse
   MCP_TRANSPORT=http npm run dev  # Starts server on http://localhost:3157/mcp

然后配置Claude以连接到它:

   {
     "mcpServers": {
       "converse-local": {
         "url": "http://localhost:3157/mcp"
       }
     }
   }

重要：HTTP传输要求服务器在Claude连接之前运行。使用Claude时，保持终端与服务器打开。

配置文件位置

Claude配置文件通常位于：

窗户： %APPDATA%\Claude\claude_desktop_config.json
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

有关更多详细说明，请参阅官方MCP配置指南.

💻 独立运行（无克劳德）

您可以在没有Claude的情况下直接运行服务器进行测试或开发：

# Quick run (no installation needed)
npx converse-mcp-server

# Alternative package managers
pnpm dlx converse-mcp-server
yarn dlx converse-mcp-server

有关开发设置，请参阅发展下面的部分。

🐛 故障排除

常见问题

服务器无法启动：

检查Node.js版本： node --version （需要v20+）
尝试其他端口： PORT=3001 npm start

API关键错误：

验证.env文件的格式是否正确
测试： npm run test:real-api

模块导入错误：

清除缓存并重新安装： npm run clean

调试模式

# Enable debug logging
LOG_LEVEL=debug npm run dev

# Start with debugger
npm run debug

# Trace all operations
LOG_LEVEL=trace npm run dev

🔧 发展

入门指南

# Clone the repository
git clone https://github.com/FallDownTheSystem/converse.git
cd converse
npm install

# Copy environment file and add your API keys
cp .env.example .env

# Start development server
npm run dev

可用脚本

# Server management
npm start              # Start server (auto-kills existing server on port 3157)
npm run start:clean    # Start server without killing existing processes
npm run start:port     # Start server on port 3001 (avoids port conflicts)
npm run dev            # Development with hot reload (auto-kills existing server)
npm run dev:clean      # Development without killing existing processes
npm run dev:port       # Development on port 3001 (avoids port conflicts)
npm run dev:quiet      # Development with minimal logging
npm run kill-server    # Kill any server running on port 3157

# Testing
npm test               # Run all tests
npm run test:unit      # Unit tests only
npm run test:integration # Integration tests
npm run test:e2e       # End-to-end tests (requires API keys)

# Integration test subcategories
npm run test:integration:mcp        # MCP protocol tests
npm run test:integration:tools      # Tool integration tests
npm run test:integration:providers  # Provider integration tests
npm run test:integration:performance # Performance tests
npm run test:integration:general    # General integration tests

# Other test categories
npm run test:mcp-client # MCP client tests (HTTP-based)
npm run test:providers # Provider unit tests
npm run test:tools     # Tool tests
npm run test:coverage  # Coverage report
npm run test:watch     # Run tests in watch mode

# Code quality
npm run lint           # Check code style
npm run lint:fix       # Fix code style issues
npm run format         # Format code with Prettier
npm run validate       # Full validation (lint + test)

# Utilities
npm run build          # Build for production
npm run debug          # Start with debugger
npm run check-deps     # Check for outdated dependencies
npm run kill-server    # Kill any server running on port 3157

开发说明

端口冲突：服务器默认使用端口3157。如果出现“EADDRINUSE”错误：

跑 npm run kill-server 释放港口
或者使用其他端口： PORT=3001 npm start

运输方式:

工作室 （默认）：与Claude自动配合使用
超文本传输协议：更适合调试，需要手动启动(MCP_TRANSPORT=http npm run dev)

使用真实API进行测试

在中设置API密钥后 .env:

# Run end-to-end tests
npm run test:e2e

# Test specific providers
npm run test:integration:providers

# Full validation
npm run validate

验证步骤

安装后，运行这些测试以验证一切正常：

npm start           # Should show startup message
npm test            # Should pass all unit tests
npm run validate    # Full validation suite

项目结构

converse/
├── src/
│   ├── index.js              # Main server entry point
│   ├── config.js             # Configuration management
│   ├── router.js             # Central request dispatcher
│   ├── continuationStore.js  # State management
│   ├── systemPrompts.js      # Tool system prompts
│   ├── providers/            # AI provider implementations
│   │   ├── index.js          # Provider registry
│   │   ├── interface.js      # Unified provider interface
│   │   ├── openai.js         # OpenAI provider
│   │   ├── xai.js            # XAI provider
│   │   ├── google.js         # Google provider
│   │   ├── anthropic.js      # Anthropic provider
│   │   ├── mistral.js        # Mistral AI provider
│   │   ├── deepseek.js       # DeepSeek provider
│   │   ├── openrouter.js     # OpenRouter provider
│   │   └── openai-compatible.js # Base for OpenAI-compatible APIs
│   ├── tools/                # MCP tool implementations
│   │   ├── index.js          # Tool registry
│   │   ├── chat.js           # Chat tool
│   │   └── consensus.js      # Consensus tool
│   └── utils/                # Utility modules
│       ├── contextProcessor.js # File/image processing
│       ├── errorHandler.js   # Error handling
│       └── logger.js         # Logging utilities
├── tests/                    # Comprehensive test suite
├── docs/                     # API and architecture docs
└── package.json              # Dependencies and scripts

📦 向NPM发布

备注：本节适用于维护人员。该包已发布为 converse-mcp-server.

快速发布检查表

# 1. Ensure clean working directory
git status

# 2. Run full validation
npm run validate

# 3. Test package contents
npm pack --dry-run

# 4. Test bin script
node bin/converse.js --help

# 5. Bump version (choose one)
npm version patch    # Bug fixes: 1.0.1 → 1.0.2
npm version minor    # New features: 1.0.1 → 1.1.0
npm version major    # Breaking changes: 1.0.1 → 2.0.0

# 6. Test publish (dry run)
npm publish --dry-run

# 7. Publish to npm
npm publish

# 8. Verify publication
npm view converse-mcp-server
npx converse-mcp-server --help

版本指南

补丁 (npm version patch)：Bug修复、文档更新、细微改进
次要的 (npm version minor)：新功能、新型号支持、新工具功能
主修 (npm version major)：突破API变化，重大架构变化

出版后

发布后，如有需要，更新安装说明并验证：

# Test direct execution
npx converse-mcp-server
npx converse

# Test MCP client integration
# Update Claude Desktop config to use: "npx converse-mcp-server"

故障排除出版物

Git不干净：首先提交所有更改
测试失败：在发布之前修复问题
版本冲突：检查现有版本 npm view converse-mcp-server versions
权限问题：确保您已使用登录 npm whoami

🤝 贡献

复刻仓库
创建要素分支： git checkout -b feature/amazing-feature
进行更改
运行测试： npm run validate
提交更改： git commit -m 'Add amazing feature'
推送到分支： git push origin feature/amazing-feature
打开拉取请求

开发设置

# Fork and clone your fork
git clone https://github.com/yourusername/converse.git
cd converse

# Install dependencies
npm install

# Create feature branch
git checkout -b feature/your-feature

# Make changes and test
npm run validate

# Commit and push
git add .
git commit -m "Description of changes"
git push origin feature/your-feature

🙏 致谢

此MCP服务器受以下优秀工作的启发并在此基础上构建 BeehiveInnovations/zen-mcp服务器.

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🔗 链接

GitHub: https://github.com/FallDownTheSystem/converse
问题: https://github.com/FallDownTheSystem/converse/issues
NPM包: https://www.npmjs.com/package/converse-mcp-server

Converse MCP Server

快速接入

详细介绍