MCP 对话服务器

一个模型上下文协议 (MCP) 服务器实现，用于管理与 OpenRouter 语言模型的对话。该服务器为应用程序提供了一个标准化的接口，通过统一的对话管理系统与各种语言模型进行交互。

特性

• MCP 协议支持

  • 完全符合 MCP 协议
  • 资源管理和发现
  • 基于工具的交互模型
  • 流式响应支持
  • 错误处理和恢复

• OpenRouter 集成

  • 支持所有 OpenRouter 模型
  • 实时流式响应
  • 自动 Token 计数
  • 模型上下文窗口管理
  • 可用模型包括：
    • Claude 3 Opus
    • Claude 3 Sonnet
    • Llama 2 70B
    • 以及 OpenRouter 目录中的更多模型

• 对话管理

  • 创建和管理多个对话
  • 支持系统消息
  • 消息历史记录跟踪
  • Token 使用情况监控
  • 对话过滤和搜索

• 流式支持

  • 实时消息流式传输
  • 分块响应处理
  • Token 计数

• 文件系统持久化

  • 对话状态持久化
  • 可配置的存储位置
  • 自动状态管理

安装

npm install mcp-conversation-server

配置

配置

MCP 对话服务器的所有配置现在都通过 YAML 提供。请使用您的设置更新 config/models.yaml 文件。例如：

# MCP 服务器配置
openRouter:
  apiKey: "YOUR_OPENROUTER_API_KEY"  # 替换为您的实际 OpenRouter API 密钥。

persistence:
  path: "./conversations"  # 用于存储对话数据的目录。

models:
  # 在此处定义您的模型
  'provider/model-name':
    id: 'provider/model-name'
    contextWindow: 123456
    streaming: true
    temperature: 0.7
    description: '模型描述'

# 如果未指定，则使用的默认模型
defaultModel: 'provider/model-name'

服务器配置

MCP 对话服务器现在从 YAML 文件加载其所有配置。在您的应用程序中，您可以按如下方式加载配置：

const config = await loadModelsConfig(); // 从 'config/models.yaml' 加载 openRouter、persistence、models 和 defaultModel 设置

注意：不再需要环境变量，因为所有配置都通过 YAML 文件提供。

用法

基本服务器设置

import { ConversationServer } from 'mcp-conversation-server';

const server = new ConversationServer(config);
server.run().catch(console.error);

可用工具

服务器公开了几个 MCP 工具：

1. create-conversation

   {
       provider: 'openrouter',    // Provider 始终为 'openrouter'
       model: string,             // OpenRouter 模型 ID (例如，'anthropic/claude-3-opus-20240229')
       title?: string;            // 可选的对话标题
   }
   

2. send-message

   {
       conversationId: string;  // 对话 ID
       content: string;         // 消息内容
       stream?: boolean;        // 启用流式响应
   }
   

3. list-conversations

   {
       filter?: {
           model?: string;      // 按模型过滤
           startDate?: string;  // 按开始日期过滤
           endDate?: string;    // 按结束日期过滤
       }
   }
   

资源

服务器提供对以下几个资源的访问：

1. conversation://{id}

   • 访问特定对话的详细信息
   • 查看消息历史记录
   • 检查对话元数据

2. conversation://list

   • 列出所有活动对话
   • 按条件过滤对话
   • 按最近活动排序

开发

构建

npm run build

运行测试

npm test

调试

服务器提供几个调试功能：

1. 错误日志记录

   • 所有错误都记录有堆栈跟踪
   • Token 使用情况跟踪
   • 速率限制监控

2. MCP Inspector

   npm run inspector
   

   使用 MCP Inspector 来：

   • 测试工具执行
   • 查看资源内容
   • 监控消息流
   • 验证协议合规性

3. Provider 验证

   await server.providerManager.validateProviders();
   

   验证：

   • API 密钥有效性
   • 模型可用性
   • 速率限制状态

故障排除

常见问题和解决方案：

1. OpenRouter 连接问题

   • 验证您的 API 密钥是否有效
   • 检查 OpenRouter 仪表板 上的速率限制
   • 确保模型 ID 正确
   • 监控信用使用情况

2. 消息流式传输错误

   • 验证模型流式传输支持
   • 检查连接稳定性
   • 监控 Token 限制
   • 处理超时设置

3. 文件系统错误

   • 检查目录权限
   • 验证路径配置
   • 监控磁盘空间
   • 处理并发访问

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

ISC 许可证