MCP Server

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(用于容器化部署)

基本安装

  1. 克隆仓库
git clone https://github.com/cnewave/mcp-server-dev.git
cd mcp-server-dev
  1. 安装依赖
npm install
  1. 配置服务器

复制示例配置文件并根据您的环境进行修改:

cp config/config.example.json config/config.json

编辑 config/config.json 以设置您的数据库连接、安全设置和其他选项。

  1. 运行服务器
npm start

默认情况下,服务器将在 http://localhost:3000 上可用。

Docker 安装

  1. 构建并启动容器
docker-compose up -d

这将启动 MCP 服务器以及 MongoDB 和 Redis 实例。

生产环境部署

对于生产环境,我们建议:

  1. 使用环境变量而不是配置文件
  2. 设置适当的监控和日志记录
  3. 配置反向代理(Nginx、HAProxy)以进行 SSL 终止
  4. 为数据库实施适当的备份策略

示例生产环境启动:

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 来源 *

下一步

安装后,您可能需要:

  1. 创建您的第一个服务
  2. 设置身份验证
  3. 配置客户端连接
  4. 浏览 API 文档

贡献

我们欢迎对 MCP 服务器项目的贡献! 请参阅 CONTRIBUTING.md 了解如何开始。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

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

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。

官方
本地
JavaScript