AI导哈

MCP应用启动套件

一个用于快速构建具有认证、数据库和计费功能的MCP应用的通用启动套件，适用于开发者和团队。

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

使用说明

MCP入门套件

在几秒钟内创建带有认证、数据库和计费功能的MCP应用程序！

一个通用的启动工具包，用于构建带有内置身份验证（Kinde）、数据库（Neon PostgreSQL）和计费系统（Kinde）的模型上下文协议（MCP）应用程序。非常适合希望使用Cursor开始构建MCP服务器的开发者。

特点/特性

  • 内置认证 - Kinde OAuth 集成
  • 数据库准备就绪 - 带有自动模式设置的 Neon PostgreSQL
  • 计费系统 - 免费增值模式，含升级流程
  • 多个模板 - 博客、电子商务、客户关系管理（CRM）、待办事项应用程序
  • 一键设置 - 交互式命令行界面，实现即时项目创建
  • 完整堆栈 - 认证服务器 + MCP服务器 + 数据库
  • 光标集成 - 准备与Cursor AI一起使用

非常适合

  • 开发者 使用Cursor构建MCP服务器
  • 团队 创建带有认证和计费功能的CRUD MCP服务器
  • 任何人 谁想轻松设置StarKit（假设为某软件或工具名）

快速入门

# Create a new MCP application (one command!)
npx mcp-starter-kit

这将创建您的项目，并引导您完成设置过程。

注忽略 npm i mcp-starter-kit npm 包页面上显示的命令。使用 npx mcp-starter-kit 以换取最佳体验。

可用模板

模板 描述 实体 最适合
博客 博客管理系统 文章、评论 内容创作者、作家
电子商务 电商平台 产品、订单、订单项 在线商店、市场平台
客户关系管理（Customer Relationship Management） 客户关系管理 联系人、交易、任务 销售团队、企业
一切 简单待办事项系统 待办事项 个人生产力，任务管理

完整安装指南

第一步：创建您的应用程序

npx mcp-starter-kit

你将看到：

🚀 MCP Starter Kit
Create MCP applications with authentication, database, and billing

📝 What would you like to name your application? my-blog
📋 Choose your template:
  1. blog      - Blog management system (posts, comments)
  2. ecommerce - E-commerce system (products, orders)
  3. crm       - Customer relationship management (contacts, deals, tasks)
  4. todo      - Simple todo management system

🎯 Enter your choice (1-4): 1
🚀 Creating my-blog with blog template...
✅ Application created successfully!

步骤2：安装依赖项

npm install

第三步：配置环境

# Copy environment template
cp .env.example .env

配置您的 .env 文件：

# Database (Get from Neon)
DATABASE_URL=postgresql://username:password@host:port/database

# Kinde Authentication (Get from Kinde)
KINDE_ISSUER_URL=https://your-domain.kinde.com
KINDE_CLIENT_ID=your_client_id
KINDE_CLIENT_SECRET=your_client_secret

# JWT Configuration
JWT_SECRET=your_jwt_secret_key

# Server Configuration
NODE_ENV=development

步骤4：设置数据库

# Create database schema
npm run setup-db

步骤5：启动认证服务器

# In a separate terminal
npm run auth-server

参观 http://localhost:3000 登录并获取您的身份验证令牌。

步骤6：启动MCP服务器

# In another terminal
npm run dev

步骤7：配置光标

添加到您的Cursor MCP配置中（~/.cursor/mcp.json)：

{
  "mcpServers": {
    "my-blog": {
      "command": "node",
      "args": ["dist/universal-server.js"],
      "cwd": "/path/to/your/my-blog",
      "env": {
        "DATABASE_URL": "your_database_url",
        "KINDE_ISSUER_URL": "your_kinde_issuer_url",
        "KINDE_CLIENT_ID": "your_kinde_client_id",
        "KINDE_CLIENT_SECRET": "your_kinde_client_secret",
        "JWT_SECRET": "your_jwt_secret"
      }
    }
  }
}

认证流程

  1. 启动认证服务器 - npm run auth-server
  2. 访问登录页面 - http://localhost:3000
  3. 使用Kinde登录 - 完整的OAuth流程
  4. 复制身份令牌 - 来自认证页面
  5. 在光标中使用 - 使用 save_token 使用你的令牌（或令牌工具）
  6. 开始建造 - 在Cursor聊天中使用MCP工具

可用的MCP工具

认证通过后，您将可以访问：

  • 认证工具

    • login - 获取认证URL
    • save_token - 保存您的身份验证令牌
    • logout - 注销当前用户
    • refresh_billing_status - 检查账单状态

  • CRUD 工具 （基于您的模板）

    • create_[entity] - 创建新项目
    • list_[entity]s - 列出所有项目
    • get_[entity] - 获取特定项目
    • update_[entity] - 更新现有项目
    • delete_[entity] - 删除项目

计费系统

  • 免费层级/免费套餐 - 有限项目（可根据模板进行配置）
  • 升级流程 - 自动重定向到Kinde计费门户
  • 使用追踪 - 自动追踪免费层级的使用情况
  • 计划管理 - 检查当前计划和使用情况

项目结构

my-blog/
├── package.json              # Dependencies and scripts
├── tsconfig.json             # TypeScript configuration
├── .env.example              # Environment template
├── README.md                 # Project documentation
└── src/
    ├── app-config.ts         # Application configuration
    ├── universal-server.ts   # Main MCP server
    ├── setup-db.ts          # Database setup script
    ├── kinde-auth-server.ts  # Authentication server
    └── core/                 # Core MCP modules
        ├── auth/             # Authentication manager
        ├── database/         # Database manager
        ├── server/           # MCP server core
        └── tools/            # Tool factory

故障排除

常见问题

在光标中未检测到MCP服务器：

  • 检查 ~/.cursor/mcp.json 语法
  • 验证环境变量
  • 重启光标
  • 检查服务器是否正在运行

认证问题：

  • 验证Kinde凭据
  • 在Kinde仪表板中检查重定向URL
  • 确保认证服务器正在3000端口上运行

数据库连接问题：

  • 验证Neon数据库URL
  • 检查数据库权限
  • 跑 npm run setup-db 创建模式

寻求帮助

  • 检查项目中生成的README文件
  • 验证所有环境变量是否已设置
  • 确保两台服务器都在运行
  • 检查光标MCP配置

为何选择这个？

  • 快速设置 - 从零开始到运行MCP应用只需几分钟
  • 生产就绪 - 真实认证和数据库
  • 账单准备就绪 - 内置免费增值模式
  • 多个模板 - 选择符合您需求的选项
  • 完整栈（或称为“全栈”） - 包含您所需的一切
  • 光标优化 - 非常适合人工智能开发

接下来呢？

  1. 创建你的第一个应用程序 - npx mcp-starter-kit
  2. 选择您的模板 - 博客、电子商务、客户关系管理（CRM）或待办事项
  3. 配置您的服务 - Neon 数据库 + Kinde 认证
  4. 开始构建 - 在Cursor中使用MCP工具
  5. 部署和扩展 - 您的应用已准备好投入生产

📄 许可证

MIT 许可证 - 详见 LICENSE 文件。

贡献

欢迎投稿！请阅读我们的 贡献指南。

准备好构建你的第一个MCP应用程序了吗？开始吧 npx mcp-starter-kit 并开始建造！

相关 MCP