MCP^2(MCPSQ)

MCP^2(MCPSQ) 是一个简单的 MCP 服务器，用于发现和管理 MCP 服务器。更多详情请访问我们的网站 mcpsq.xyz。

使用方法

npm start

本地开发

预备条件

• Node.js (v18 或更高版本)
• Cursor 编辑器

安装

1. 克隆仓库：

git clone https://github.com/xinbenlv/mcpsq.git
cd mcpsq

2. 安装依赖：

npm install

运行服务器

在本地启动 MCP 服务器：

# 生产模式
npm start

# 开发模式，自动重载
npm run dev

# 将 TypeScript 编译成 JavaScript
npm run build

服务器将在 http://localhost:3000 启动，并提供以下服务：

• 在 GET /mcp 处提供 SSE 端点
• 在 POST /messages 处处理消息

配置 Cursor MCP 集成

要将此 MCP 服务器与 Cursor 结合使用，请在您的 Cursor MCP 设置中添加以下配置：

方案 1：全局配置

创建或编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "mcpsq": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

方案 2：项目特定配置

在项目根目录下创建 .cursor/mcp.json：

{
  "mcpServers": {
    "mcpsq": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

可用的 MCP 工具

配置完成后，以下工具将在 Cursor 中可用：

• find-mcp-server：搜索与查询相关的 MCP 服务器
• add-mcp-server-to-cursor：将 MCP 服务器添加到您的 Cursor 配置中
• list-current-mcp-servers：列出所有已配置的 MCP 服务器
• remove-mcp-server-from-cursor：从配置中移除 MCP 服务器

测试集成

1. 在本地启动 MCPSQ 服务器
2. 使用上述 MCP 设置配置 Cursor
3. 重新启动 Cursor 或重新加载 MCP 配置
4. 在 Cursor 聊天中尝试提问：“查找数据库管理的 MCP 服务器”
5. MCPSQ 工具应出现在可用工具列表中

开发脚本

# 在生产模式下启动服务器
npm start

# 在开发模式下启动服务器，自动重载
npm run dev

# 将 TypeScript 编译成 JavaScript
npm run build

# 清理构建目录
npm run clean

# 验证数据文件
npm run validate:data

# 不生成文件的情况下进行类型检查
npm run typecheck

开发流程

1. 开发：使用 npm run dev 进行开发，文件更改时自动重启
2. 类型检查：运行 npm run typecheck 检查 TypeScript 错误而不构建
3. 构建：使用 npm run build 将 TypeScript 编译成 JavaScript（首先自动清理）
4. 生产：使用 npm start 直接运行编译后的 TypeScript

故障排除

• 服务器无法启动：检查端口 3000 是否可用
• Cursor 无法连接：验证 MCP 配置文件路径和 JSON 语法
• 工具未出现：检查 Cursor 的 MCP 日志输出面板
• TypeScript 错误：运行 npm run typecheck 查看详细的错误信息

Heroku 部署

MCPSQ 可以轻松部署到 Heroku 以实现云托管：

预备条件

• 安装了 Heroku CLI
• Heroku 账户

部署步骤

1. 登录到 Heroku：

heroku login

2. 创建一个新的 Heroku 应用：

heroku create your-mcpsq-app-name

3. 部署到 Heroku：

git push heroku main

4. 打开已部署的应用：

heroku open

配置

应用将自动：

• 使用 Heroku 的 PORT 环境变量
• 在部署期间通过 heroku-postbuild 脚本构建 TypeScript 代码
• 使用编译后的 JavaScript 启动服务器

您的 MCPSQ 服务器将在以下位置可用：

• MCP 端点：https://your-app-name.herokuapp.com/mcp

使用 Cursor

配置 Cursor 使用您在 Heroku 上部署的 MCPSQ 服务器：

{
  "mcpServers": {
    "mcpsq": {
      "url": "https://your-app-name.herokuapp.com/mcp"
    }
  }
}

数据

数据存储在 data 目录中。

贡献

欢迎贡献！请随意提交拉取请求来更新 data 目录中的数据。

发展路线图

• 处理所需环境变量
• 发布到 npmjs.com
• 添加 Heroku 部署支持

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。 </中文翻译>