MCP Server
MCP (Managed Communication Protocol) 服务器的开发仓库
cnewave
README
MCP 服务器
概述
MCP (Managed Communication Protocol) 服务器是一个现代、可扩展且安全的通信协议服务器,旨在促进客户端和服务之间的无缝交互。此开发仓库包含设置和扩展 MCP 服务器基础设施所需的源代码、文档和工具。
概念
MCP 服务器围绕几个核心概念构建:
1. 受管理通信
MCP 提供了一种标准化方式来处理不同系统、应用程序和服务之间的通信。它抽象了网络协议、序列化格式和连接管理的复杂性,使开发人员能够专注于业务逻辑。
2. 协议无关
该服务器旨在通过统一的接口支持多种协议(HTTP/HTTPS、WebSockets、gRPC 等)。这允许客户端使用他们首选的协议进行连接,而服务器处理转换和路由。
3. 服务发现
MCP 包括内置的服务发现机制,允许服务注册自身,并允许客户端动态发现可用的服务。
4. 安全第一
安全性是 MCP 的一个基本方面,其功能包括:
- 端到端加密
- 身份验证和授权
- 速率限制和 DDoS 防护
- 审计日志
5. 可扩展性
该架构专为水平扩展而设计,允许您随着负载的增加添加更多服务器实例。
系统架构
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ │ │ │ │ │
│ 客户端 │◄───►│ MCP 服务器 │◄───►│ 服务 │
│ │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────────┘
│
┌──────┴──────┐
│ │
│ 数据库 │
│ │
└─────────────┘
安装
前提条件
- Node.js (v16 或更高版本)
- MongoDB (v4.4 或更高版本)
- Redis (可选,用于缓存)
- Docker 和 Docker Compose(用于容器化部署)
基本安装
- 克隆仓库
git clone https://github.com/cnewave/mcp-server-dev.git
cd mcp-server-dev
- 安装依赖
npm install
- 配置服务器
复制示例配置文件并根据您的环境进行修改:
cp config/config.example.json config/config.json
编辑 config/config.json
以设置您的数据库连接、安全设置和其他选项。
- 运行服务器
npm start
默认情况下,服务器将在 http://localhost:3000
上可用。
Docker 安装
- 构建并启动容器
docker-compose up -d
这将启动 MCP 服务器以及 MongoDB 和 Redis 实例。
生产环境部署
对于生产环境,我们建议:
- 使用环境变量而不是配置文件
- 设置适当的监控和日志记录
- 配置反向代理(Nginx、HAProxy)以进行 SSL 终止
- 为数据库实施适当的备份策略
示例生产环境启动:
NODE_ENV=production \
DB_URI=mongodb://user:password@mongodb:27017/mcp \
AUTH_SECRET=your-secret-key \
npm start
配置选项
MCP 服务器可以通过以下方式进行配置:
- 配置文件
- 环境变量
- 命令行参数
主要配置选项包括:
选项 | 描述 | 默认值 |
---|---|---|
port |
服务器监听端口 | 3000 |
dbUri |
MongoDB 连接字符串 | mongodb://localhost:27017/mcp |
logLevel |
日志记录详细程度 | info |
authSecret |
JWT 令牌的密钥 | (必需) |
corsOrigins |
允许的 CORS 来源 | * |
下一步
安装后,您可能需要:
- 创建您的第一个服务
- 设置身份验证
- 配置客户端连接
- 浏览 API 文档
贡献
我们欢迎对 MCP 服务器项目的贡献! 请参阅 CONTRIBUTING.md 了解如何开始。
许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。
推荐服务器
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
MCP Package Docs Server
促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。
Claude Code MCP
一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。
@kazuph/mcp-taskmanager
用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。
mermaid-mcp-server
一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。
Jira-Context-MCP
MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

Linear MCP Server
一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。
Curri MCP Server
通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。