mcpsq (Xinbenlv)

MCP^2（MCPSQ）


MCP^2（MCPSQ）是一个简单的MCP服务器，用于发现和管理MCP服务器。查看我们的网站 mcpsq.xyz 了解更多信息。

用法

npm start

地方发展

先决条件

• （v18或更高版本）
• 光标 编辑

安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

运行服务器

在本地启动MCP服务器：

# Production mode
npm start

# Development mode with auto-reload
npm run dev

# Build TypeScript to JavaScript
npm run build

服务器将于启动 http://localhost:3000 并提供：

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

配置游标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服务器添加到游标配置中
• list-current-mcp-servers：列出当前配置的所有MCP服务器
• remove-mcp-server-from-cursor：从配置中删除MCP服务器

测试集成

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

开发脚本

# Start the server in production mode
npm start

# Start the server in development mode with auto-reload
npm run dev

# Build TypeScript to JavaScript
npm run build

# Clean build directory
npm run clean

# Validate data files
npm run validate:data

# Type checking without emitting files
npm run typecheck

开发工作流程

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

故障排除

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

Heroku部署

MCPSQ可以轻松部署到Heroku进行云托管：

先决条件

• Heroku命令行界面 安装
• Heroku帐户

部署步骤

1. 登录Heroku:

heroku login

1. 创建新的Heroku应用程序:

heroku create your-mcpsq-app-name

1. 部署到Heroku:

git push heroku main

1. 打开已部署的应用程序:

heroku open

配置

应用程序将自动：

• 使用Heroku的 PORT 环境变量
• 在部署过程中通过以下方式构建TypeScript代码 heroku-postbuild 脚本
• 使用编译的JavaScript启动服务器

您的MCPSQ服务器将在以下地点提供：

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

与光标一起使用

配置Cursor以使用Heroku部署的MCPSQ服务器：

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

数据

数据存储在 data 目录。

贡献

欢迎投稿！请随时提交一个拉取请求，以更新 data 目录.

路线图

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

许可证

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