MCP Starter Project

MCP Server Starter

想构建自己的 MCP 服务吗？

MCP Server Starter 为你提供基础结构，让你能够使用 MCP 标准，通过 Cursor、Claude 等工具运行本地工具。

---

功能特性

• 📡 灵活的通信方式

  • 支持客户端与服务之间的多种通信协议，
  • stdio：本地使用
  • Streamable HTTP：远程和本地使用
  • sse：远程和本地使用（已弃用）~~

• 📦 最简配置 - 通过基础服务实现快速入门。

• 🤖 Cursor AI 集成 - 包含 .cursor/mcp.json 配置示例。

• ⌨️ TypeScript - 为项目添加类型安全。

待办事项

• 添加发布自有软件包的选项
• 改进脚手架的 CLI 支持
• 添加用于即时构建工具的提示词

快速开始

前提条件

• Node.js（如有需要，请指定版本）
• 兼容 MCP 的客户端（例如 Cursor）

用法

支持的传输选项

Model Context Protocol 支持多种传输方式。

stdio

推荐用于本地配置

代码编辑器支持

添加以下代码片段

• Cursor：.cursor/mcp.json

本地开发／测试

如果你想在本地测试 MCP 服务，请使用此配置

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--stdio"]
    }
  }
}

已发布的软件包

如果你已在 npm registry 中发布软件包，请使用此配置

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "npx",
      "args": ["my-mcp-server", "--stdio"]
    }
  }
}

Streamable HTTP

重要：Cursor 目前尚不支持 Streamable HTTP

推荐用于远程服务

重要： 与 stdio 不同，你还需要使用正确的标志运行服务。

本地开发 使用 streamable http 传输方式

1. 启动 MCP 服务 在终端中运行此命令

node ./bin/cli.mjs --http --port 4200

或使用 mcp inspector

npm run dev-http
# npm run dev-sse (deprecated)

2. 将以下内容添加到配置中

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--http", "--port", "4001"]
      // "args": ["./bin/cli.mjs", "--sse", "--port", "4002"] (or deprecated sse usage)
    }
  }
}

已发布的软件包

如果你已在 npm registry 中发布软件包，请使用此配置

在终端中运行此命令

npx my-mcp-server --http --port 4200
# npx my-mcp-server --sse --port 4201 (deprecated)

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "url": "http://localhost:4200/mcp"
      // "url": "http://localhost:4201/sse"
    }
  }
}

使用 Inspector

使用 inspect 命令调试 MCP 服务

命令行选项

协议选择

协议	描述	标志	备注
stdio	标准输入／输出	（无）	默认
http	HTTP REST	--port <num>（默认：3000），--endpoint <path>（默认：/mcp）
sse	服务器发送事件	--port <num>（默认：3000）	已弃用

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

---

课程

• 学习使用 AI 构建软件：instructa.ai