Express MCP Server

Name: Express MCP Server
Author: jhgaylor

本地服务

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

代码仓库

关于 Express MCP Server

Express MCP Server 是面向 MCP 集成开发者的无状态 TypeScript 和 Express 示例服务。它通过 Streamable HTTP 提供 echo 资源、工具和提示词，以展示协议用法。

主要功能

01无状态 MCP 实现
02Streamable HTTP 传输
03消息 echo 资源
04echo 工具响应
05echo 提示词生成

适用场景

01测试 MCP JSON-RPC 请求
02了解资源、工具和提示词的行为
03以 TypeScript 和 Express 示例为基础开发

MCP 相关

通过 Streamable HTTP 的无状态 MCP 端点提供 echo 资源、工具和提示词。该端点在 `/mcp` 接收 JSON-RPC 请求。

#express-mcp #text-extractor #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 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
  }'