MCP服务器启动器

MCP Server Starter 提供了一个基本结构,用于使用MCP标准运行本地工具,如Cursor、Claude等。

  • by instructa
  • TypeScript
  • 本地部署
  • 37 星标
  • 更新于
在 GitHub 查看 instructa/mcp-starter

使用说明

MCP服务器启动器

Created by

想建立自己的MCP服务器吗?

MCP Server Starter为您提供了使用Cursor、Claude和其他使用MCP标准运行本地工具的基本结构。


特性

  • 📡 灵活的沟通

    • 支持客户端和服务器之间的多种通信协议,
    • stdio:本地使用
    • Streamable HTTP:远程和本地使用
    • sse:远程和本地使用(已弃用)~~
  • 📦 最小设置 -快速开始使用基本的服务器实现。

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

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

全部

  • []添加发布自己的包的选项
  • []更好的CLI支持脚手架
  • []提示即时构建工具

入门指南

先决条件

  • Node.js (如有必要,请指定版本)
  • MCP兼容客户端(例如。, 光标)

用法

支持的传输选项

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

标准输入输出

建议用于本地设置

代码编辑器支持

添加下面的代码片段

  • 光标: .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"]
    }
  }
}

流式HTTP

重要提示:Cursor尚不支持流式HTTP

建议使用远程服务器

重要提示: 与stdio相反,您还需要使用正确的标志运行服务器

地方发展 使用 streamable http 运输

  1. 启动MCP服务器 在你的终端上运行这个
node ./bin/cli.mjs --http --port 4200

或与mcp检查员联系

npm run dev-http
# npm run dev-sse (deprecated)
  1. 将此添加到您的配置中
{
  "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注册表中发布了你的包时,使用这个

在你的终端上运行这个

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"
    }
  }
}

使用检查器

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

命令行选项

协议选择

协议 描述 标志 注释
stdio 标准I/O (无) 默认
http HTTP休息 --port <num> (编号:3000), --endpoint <path> (def: /mcp)
sse 服务器发送的事件 --port <num> (定义:3000) 已弃用

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。


课程