MCP Conversation Server
2025.02.18
0
TypeScript对话管理语言模型交互API 接口交流协作开发效率
MCP Conversation Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，用于管理与 OpenRouter 语言模型的对话。该服务器为应用程序提供了一个标准化的接口，通过统一的对话管理系统与各种语言模型进行交互。
View on GitHub
Overview
基本能力
产品定位
MCP Conversation Server 是一个对话管理系统，专为与 OpenRouter 的语言模型交互而设计，提供标准化的接口和工具集。
核心功能
- MCP 协议支持：完全兼容 MCP 协议，包括资源管理、发现、工具交互模型、流式响应支持和错误处理。
- OpenRouter 集成：支持所有 OpenRouter 模型，提供实时流式响应、自动令牌计数和模型上下文窗口管理。
- 对话管理：创建和管理多个对话，支持系统消息、消息历史跟踪、令牌使用监控和对话过滤搜索。
- 流式支持：实时消息流式传输、分块响应处理和令牌计数。
- 文件系统持久化：对话状态持久化，可配置存储位置和自动状态管理。
适用场景
- 需要与多种语言模型交互的应用程序。
- 需要管理多个对话并跟踪历史记录的开发项目。
- 需要实时流式响应和令牌管理的 AI 应用。
工具列表
- create-conversation：创建新对话，指定模型和可选标题。
- send-message：发送消息到指定对话，支持流式响应。
- list-conversations：列出所有对话，支持按模型、日期等过滤。
常见问题解答
- OpenRouter 连接问题：验证 API 密钥有效性，检查速率限制和模型 ID 是否正确。
- 消息流式错误：确认模型支持流式，检查连接稳定性和令牌限制。
- 文件系统错误：检查目录权限、路径配置和磁盘空间。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
npm install mcp-conversation-server
配置
在 config/models.yaml 文件中配置 OpenRouter API 密钥、持久化路径和模型设置。
基本服务器设置
import { ConversationServer } from 'mcp-conversation-server';
const server = new ConversationServer(config);
server.run().catch(console.error);
调试方式
- 错误日志：查看错误堆栈、令牌使用和速率限制监控。
- MCP 检查器：运行
npm run inspector测试工具执行和监控消息流。 - 提供者验证：使用
server.providerManager.validateProviders()验证 API 密钥和模型可用性。