MCP对话服务器

这是一个用于管理与OpenRouter语言模型对话的Model Context Protocol（MCP）服务器实现。该服务器提供了一个标准化接口，使应用程序能够通过统一的对话管理系统与各种语言模型进行交互。

特性

• MCP协议支持

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

• OpenRouter集成

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

• 对话管理

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

• 流式支持

  • 实时消息流
  • 分块响应处理
  • 令牌计数

• 文件系统持久化

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

安装

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. 创建对话

   {
       provider: 'openrouter',    // 提供者始终是'openrouter'
       model: string,             // OpenRouter模型ID（例如，'anthropic/claude-3-opus-20240229'）
       title?: string;            // 可选的对话标题
   }
   

2. 发送消息

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

3. 列出对话

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

资源

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

1. conversation://{id}

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

2. conversation://list

   • 列出所有活动对话
   • 根据标准筛选对话
   • 按最近活动排序

开发

构建

npm run build

运行测试

npm test

调试

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

1. 错误日志

   • 所有错误都带有堆栈跟踪的日志
   • 令牌使用跟踪
   • 速率限制监控

2. MCP检查器

   npm run inspector
   

   使用MCP检查器来：

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

3. 提供者验证

   await server.providerManager.validateProviders();
   

   验证：

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

故障排除

常见问题及解决方案：

1. OpenRouter连接问题

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

2. 消息流式传输错误

   • 确认模型支持流式传输
   • 检查连接稳定性
   • 监控令牌限制
   • 处理超时设置

3. 文件系统错误

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

贡献

1. 分叉仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

许可证

ISC许可证