Express MCP Server

Name: Express MCP Server
Author: jhgaylor

本地服务

github.com/jhgaylor开发工具120 周前更新

代码仓库

关于 Express MCP Server

Express MCP Server 是一个使用 Express 和 TypeScript 构建的无状态 MCP 服务示例，面向需要了解或测试 MCP 服务的开发者。它提供回显工具、资源和提示词，并使用 Streamable HTTP 传输。

主要功能

01无状态 MCP 服务
02Streamable HTTP 传输
03TypeScript 类型支持
04回显工具、资源与提示词

适用场景

01测试 MCP 客户端与服务交互
02研究 Express 中的 MCP 服务结构

MCP 相关

该服务通过 MCP 暴露回显资源、工具和提示词，并以 JSON-RPC 请求响应客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Express MCP 服务

一个使用 Express 和 TypeScript 构建的无状态模型上下文协议（MCP）服务。

功能

使用现代 Streamable HTTP 传输的无状态 MCP 服务实现
使用 TypeScript 实现类型安全
使用 Express.js 处理 HTTP 请求

要求

Node.js 18+
npm 或 yarn

安装

# Clone the repository (or download)
git clone https://github.com/your-username/sample-express-mcp-server.git
cd sample-express-mcp-server

# Install dependencies
npm install

开发

# Build the TypeScript code
npm run build

# Run in development mode with auto-reloading
npm run dev

# Run tests (when added)
npm test

服务结构

src/
  ├── index.ts                # Main application entry point
  └── server.ts               # MCP server definition with resource, tool, and prompt

可用功能

此服务实现了一个简单的回显端点，包含三个 MCP 组件：

资源：echo://{message} - 将消息作为资源返回
工具：echo - 将提供的消息作为工具响应回显
提示词：echo - 使用提供的消息创建用户提示词

MCP 协议

此服务实现了模型上下文协议（MCP），这是一种标准化的大模型与外部数据和功能交互的方式。它公开了一个无状态 API 端点，用于响应 JSON-RPC 请求。

API 用法

向 /mcp 发送包含 JSON-RPC 负载的 POST 请求：

初始化

curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {
        "roots": {
          "listChanged": true
        },
        "sampling": {}
      },
      "clientInfo": {
        "name": "ExampleClient",
        "version": "1.0.0"
      }
    }
  }'

调用 Echo 工具

curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "echo",
      "arguments": {
        "message": "Hello, World!"
      }
    },
    "id": 1
  }'