HTTP MCP服务器

提供基于Express和TypeScript的HTTP MCP服务器,支持通过HTTP端点调用MCP兼容的工具,适用于教育标准和课堂管理场景。

  • by andyrewlee
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 andyrewlee/common-core-mcp-servers

使用说明

通用核心MCP服务器(Express+TypeScript)

该仓库通过以下方式托管了Inkeep代理使用的三个HTTP MCP服务器(Express、TypeScript) mcpTool:

  • 通用核心标准MCP→ http://localhost:4311/mcp
  • 教室MCP→ http://localhost:4312/mcp
  • 视觉MCP→ http://localhost:4313/mcp

服务器实现了中描述的工具:

  • 教室-mcp.md
  • 通用标准-mcp.md
  • visuals-mcp.md

与markdown存根有什么不同:这些存根显示stdio传输使用 @modelcontextprotocol/sdk在这里,我们公开了一个HTTP端点 /mcp 具有Inkeep的简单MCP兼容形状 mcpTool 可以打电话。

在本地运行

  • 前提条件:节点20+(建议22个)
  • 安装deps: pnpm i (或 npm i)
  • 启动一台服务器:
    • 标准: pnpm dev:standards (http://localhost:4311/mcp)
    • 教室: pnpm dev:classroom (http://localhost:4312/mcp)
    • 视觉效果: pnpm dev:visuals (http://localhost:4313/mcp)

HTTP合约

  • 获取 /mcp → { protocol, server, tools } 哪里 tools[*] 有 { name, description, inputSchema }.
  • 发布 /mcp (JSON‑RPC): { jsonrpc: "2.0", id, method: "tools/list" } 或 { method: "tools/call", params: { name, arguments } }.
  • 发布 /mcp (简单): { tool: "name", arguments: { ... } }.
  • 发布 /mcp/tools/:name JSON body=参数。

备注

  • 所有工具归还 { content: [{ type: 'json', text: '<stringified JSON>' }] } 以反映常见的MCP响应。
  • CORS已打开(Access-Control-Allow-Origin: *)便于当地发展。