MCP Server Starter

<div align="center"> <!-- <img alt="NPM 下载量" src="https://img.shields.io/npm/instructa/mcpn?style=flat-square&logo=npm"> <img alt="jsDelivr 访问量 (npm)" src="https://img.shields.io/jsdelivr/npm/instructa/mcpn?style=flat-square&logo=jsdeliver"> <img alt="GitHub 赞助者" src="https://img.shields.io/github/sponsors/instructa/mcpn?style=flat-square&logo=github"> <br /> --> <strong>创建者</strong><br /> <a href="https://twitter.com/kregenrek"> <img src="https://img.shields.io/twitter/follow/kregenrek?style=social" alt="关注 @kregenrek 在 Twitter 上"> </a> </div>

想构建自己的MCP服务器吗？

MCP Server Starter为您提供了一个基本结构，可以使用Cursor、Claude等工具运行本地工具，并使用MCP标准。

---

<a href="https://glama.ai/mcp/servers/@instructa/mcp-starter"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@instructa/mcp-starter/badge" alt="起始MCP服务器" /> </a>

特性

• 📡 灵活通信

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

• 📦 最小设置 - 快速开始使用基本服务器实现。

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

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

待办事项

• 添加发布您自己包的选项
• 更好的CLI支持以搭建框架
• 提示以快速构建工具

开始使用

先决条件

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

使用方法

支持的传输选项

模型上下文协议支持多种传输方式。

stdio

推荐用于本地设置

代码编辑器支持

添加以下代码片段

• Cursor: .cursor/mcp.json

本地开发/测试

如果您想在本地测试您的mcp服务器，请使用此配置

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

已发布的包

当您已在npm注册表中发布了您的包时，请使用此配置

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

Streamable HTTP

重要：Streamable HTTP目前尚未在Cursor中支持

推荐用于远程服务器使用

重要： 与stdio不同，您需要使用正确的标志来运行服务器

本地开发 使用 streamable http 传输

1. 启动MCP服务器 在您的终端中运行以下命令

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

或使用mcp inspector

npm run dev-http
# npm run dev-sse (已弃用)

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

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--http", "--port", "4001"]
      // "args": ["./bin/cli.mjs", "--sse", "--port", "4002"] (或已弃用的sse使用)
    }
  }
}

已发布的包

当您已在npm注册表中发布了您的包时，请使用此配置

在您的终端中运行以下命令

npx my-mcp-server --http --port  4200
# npx my-mcp-server --sse --port 4201 (已弃用)

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

使用Inspector

使用 inspect 命令调试您的mcp服务器

命令行选项

协议选择

协议	描述	标志	备注
stdio	标准I/O	(无)	默认
http	HTTP REST	--port <num> (默认: 3000), --endpoint <path> (默认: /mcp)
sse	Server-Sent Events	--port <num> (默认: 3000)	已弃用

许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详情。

---

课程

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