MCP Server

MCP Server

site icon
2025.04.18 0
TypeScriptAI 模型通信实时通信服务器实现开发效率
MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,支持多种传输方法(SSE 和 STDIO),用于与 AI 模型进行实时通信。它具有完整的 MCP 实现、强大的架构设计、丰富的工具支持以及开发者友好的特性。
View on GitHub

Overview

基本能力

产品定位

MCP Server 是一个用于与 AI 模型进行实时通信的服务器实现,支持多种传输方法,适用于需要高效、可扩展的 AI 模型通信场景。

核心功能

  • 完整的 MCP 实现:完全符合 Model Context Protocol 标准。
  • 多种传输方式:支持 SSE (Server-Sent Events) 和 STDIO (标准输入/输出流)。
  • 健壮的架构:基于 Clean Architecture 和 SOLID 原则设计,具有高可维护性和可扩展性。
  • 强大的工具支持:易于扩展的工具、资源和提示。
  • 开发者友好:提供全面的日志记录、错误处理和测试支持。

适用场景

  • Web 应用程序:通过 SSE 传输实现浏览器与 AI 模型的实时通信。
  • 命令行工具:通过 STDIO 传输实现本地应用程序与 AI 模型的交互。
  • AI 模型集成:为 AI 模型提供标准化的通信接口。

工具列表

  • MCP Inspector:用于测试 MCP Server 实现的官方工具。
  • 自定义工具:支持开发者通过代码扩展功能,如添加新工具、资源和提示。

常见问题解答

  • 如何配置端口:通过 PORT 环境变量配置服务器运行的端口。
  • 如何扩展功能:通过实现 IToolIResourceIPrompt 接口来扩展功能。

使用教程

使用依赖

  • Node.js 18 或更高版本
  • Yarn 或 npm 包管理器

安装教程

# 克隆仓库
git clone https://github.com/your-username/mcp-server.git
cd mcp-server

# 安装依赖
yarn install

# 构建项目
yarn build

运行服务器

# 启动服务器
yarn start

# 构建并启动(开发模式)
yarn rebuild

调试方式

  1. 构建并启动 MCP Server
yarn build
yarn rebuild  # 如果使用 SSE 传输
# 或者
yarn start    # 手动启动
  1. 运行 MCP Inspector 测试服务器
npx @modelcontextprotocol/inspector node build/index.js
  1. 访问 Inspector UI http://127.0.0.1:6274 🚀

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。