MCP MateusData Server

MCP MateusData 服务器

一个用 TypeScript 实现的服务器，展示了简单的 模型上下文协议（MCP）——一个真正的“Hello World”示例，帮助你了解 MCP 服务的工作方式。此项目包含以下基本功能：

• 处理 JSON-RPC 请求
• 提供 add-number 和 greet 等示例工具
• 支持用于实时通信的服务器发送事件（SSE）
• 简单的客户端和服务端代码，便于测试和学习

先决条件

• Node.js（v20 或更高版本）
• npm（随 Node.js 一同安装）
• Cursor IDE（推荐）

安装

1. 克隆仓库：

git clone [email protected]:mateusdata/mcp-mateusdata-server.git
cd mcp-mateusdata-server

2. 安装依赖项：

npm install

运行项目

开发模式：

npm run dev

构建并在生产环境中运行：

npm run build
npm start

在 Cursor 中添加 MCP 服务

在 Cursor 配置文件中添加：

{
  "mcpServers": {    
  "mateusdata-mcp-server": {
   "command": "node",      
   "args": ["path/to/mcp-mateusdata-server/build/index.js"]
  }
  }
}

项目结构

mcp-mateusdata-server/
├── build/         # Compiled JavaScript files
├── src/           # Source code
    └── server.ts  # Simple MCP server example
│   └── client.js  # Simple MCP client example
├── node_modules/  # Project dependencies
├── package.json   # Project configuration and dependencies
└── tsconfig.json  # TypeScript configuration

关于

此仓库演示了模型上下文协议（MCP）的最简实现。src/client.js 文件提供了客户端如何与服务端交互的示例，可用于测试和入门学习。

使用示例

你可以在终端中使用 Bash、Zsh 或 Fish 直接与 MCP 服务交互。例如，列出可用工具：

使用值 a = 3 和 b = 5 调用工具 "add-number"：

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"add-number","arguments":{"a":3,"b":5}}}' | node build/index.js

使用参数 nome = "Mateus" 调用 "greet" 工具：

echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"greet","arguments":{"name":"Mateus"}}}' | node build/index.js

在 MCP 服务中使用 SSE（服务器发送事件）

你可以使用 SSE 与 MCP 服务进行实时通信。启动服务：

node build/index.js sse

你应该会看到：

MCP Server running with SSE on http://localhost:8765/sse

连接到 SSE 端点

在新的终端中，使用 curl 连接：

curl http://localhost:8765/sse

输出示例：

event: endpoint
data: /messages?sessionId=d9bfe7df-937c-475e-8d80-904a99f9ef4d

向服务端发送消息

从上一个输出中复制 sessionId，并使用它发送请求：

curl -X POST http://localhost:8765/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"greet","arguments":{"name":"Mateus"}}}'

服务端将通过 SSE 连接返回请求结果。

此项目采用 MIT 许可证。