MCP 启动器项目

<p> <img src="https://img.shields.io/badge/License-MIT-yellow?style=flat&colorA=18181B&colorB=28CF8D" alt="License"> <!-- 在此处添加其他相关徽章，例如，构建状态、星标 --> <!-- <a href="YOUR_REPO_LINK/stargazers"><img src="https://img.shields.io/github/stars/YOUR_USERNAME/YOUR_REPO.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="Stars"></a> --> </p>

MCP Starter - 构建您自己的本地模型上下文协议 (MCP) 服务器的基础。

此启动工具包提供了一个基本结构和示例设置，用于创建可通过 AI 助手（如 Cursor 或 Claude Desktop）使用 MCP 标准访问的自定义工具。

---

特性

• 🚀 MCP 就绪 - 轻松与 MCP 兼容的客户端集成。
• 🔧 可扩展的工具 - 简单的结构，可添加您自己的自定义工具。
• 📦 最小化设置 - 通过基本的服务器实现快速入门。
• ↔️ 基于 Anthropic MCP - 遵循 Anthropic 概述的规范。
• 🤖 Cursor AI 集成 - 包括示例 .cursor/mcp.json 配置。
• ⌨️ TypeScript - 为您的项目添加类型安全。

<!-- 添加特定于您的启动器实现的其他功能 -->

用法

本地开发

{
  "mcpServers": {
    "my-starter-mcp": {
      "command": "node",
      "args": ["./dist/index.mjs"]
    }
  }
}

开始使用

前提条件

• Node.js (如果需要，请指定版本)
• 一个 MCP 兼容的客户端 (例如, Cursor)

安装和设置

1. 克隆存储库：

   git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
   cd YOUR_REPO
   

2. 安装依赖项：

   npm install
   # or yarn install
   

3. 配置环境变量：

   • 基于 .env.example 创建一个 .env 文件。
   • 添加您的自定义工具所需的任何必要的 API 密钥或配置值。

4. 添加到您的 MCP 客户端： 将以下 MCP 配置添加到您的客户端（例如，Cursor 的 .cursor/mcp.json）：

   {
     "mcpServers": {
       "my-custom-mcp": {
         "command": "node", // 或您选择的执行命令
         "args": ["path/to/your/server/entrypoint.js"], // 根据需要调整路径
         "env": {
           // 从客户端添加服务器需要的任何环境变量，如果有
           // "EXAMPLE_API_KEY": "<INSERT_API_KEY_HERE>"
         }
       }
     }
   }
   

   • 将 "my-custom-mcp" 替换为您服务器的唯一名称。
   • 调整 "command" 和 "args" 以正确指向并运行服务器的主脚本。
   • 确保在此处或直接在服务器的环境中（例如，通过 .env 文件）配置任何必需的 env 变量。

运行服务器

npm start
# or yarn start

此命令应启动您的 MCP 服务器，使其工具可供连接的客户端使用。

可用工具

• exampleTool: 描述您的示例工具的功能。
• (在您实现更多工具时添加)

开发

该项目提供了一个起点。 您可能想要：

• 在服务器逻辑中实现您自己的自定义工具。
• 定义工具的模式（参数、描述）。
• 添加错误处理和日志记录。
• 为您的工具编写测试。

如果您计划为启动器项目本身做出贡献，请遵循贡献指南。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

---

链接

• X/Twitter: @kregenrek
• Bluesky: @kevinkern.dev

课程

• 学习 Cursor AI: Ultimate Cursor Course
• 学习使用 AI 构建软件: instructa.ai

查看我的其他项目：

• AI Prompts - 为 Cursor AI、Cline、Windsurf 和 Github Copilot 精选的 AI 提示
• codefetch - 使用一个简单的终端命令将代码转换为 LLM 的 Markdown
• aidex 一个 CLI 工具，提供有关 AI 语言模型的详细信息，帮助开发人员选择适合其需求的模型。# mcp-starter