AI导哈

统一MCP服务器

一个整合多个开源MCP服务器的统一服务，支持在VSCode、Cursor和CLI环境中无缝使用MCP。

  • by mon50
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mon50/unified_mcp_server

使用说明

集成MCP统一MCP服务器

多个OSS MCP是可以统一处理服务器的统一服务器。
VSCode / Cursor / CLI无缝环境MCP中所述修改相应参数的值。

🚀 快速启动

前提条件

  • Node.js 18以上
  • yarn 包管理器

安装

# リポジトリをクローン
git clone <repository-url>
cd unified_mcp_server

# 依存関係をインストール
yarn install

# TypeScriptをコンパイル
yarn build

起动

# 開発モードで起動（推奨）
yarn dev

首次启动时所需的MCP安装确认显示：

🔍 MCP依存関係をチェックしています...

⚠️  4個のMCPがインストールされていません：

   • Playwright MCP (@playwright/mcp)
   • Browser MCP (@browsermcp/mcp)
   • Context7 MCP (@upstash/context7-mcp)
   • Sequential Thinking MCP (@modelcontextprotocol/server-sequential-thinking)

不足しているMCPをすべてインストールしますか？ (Y/n)

📋 可用命令

基本命令

yarn dev                  # 開発モードでサーバー起動
yarn start                # 本番モードでサーバー起動（要build）
yarn build                # TypeScriptをコンパイル
yarn watch                # ファイル変更を監視してコンパイル
yarn clean                # ビルド済みファイルを削除

实用程序命令

yarn health               # サーバーのヘルスチェック
yarn install-mcps         # MCPを手動でインストール
yarn dev --help           # ヘルプを表示

🌐 端点

服务器启动后，以下端点可用：

HTTP API

  • http://localhost:5001 -主端点
  • http://localhost:5001/health -健康检查
  • http://localhost:5001/mcps - MCP列表和状态功能详细信息
  • http://localhost:5001/mcps/:name -特定MCP详细情报
  • http://localhost:5001/rpc -基于HTTP的JSON-RPC
  • http://localhost:5001/prompt-guide -提示优化指南
  • POST http://localhost:5001/suggest-mcp -提示分析MCP建议

网络套接字

  • ws://localhost:5001 -基于WebSocket的JSON-RPC
  • 实时状态更新（30秒间隔）

💻 Cursor/VSCode连携

自动设定

服务器启动时 .cursor/mcp_config.json 将自动生成：

{
  "mcpServers": {
    "unified-mcp": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "UNIFIED_MCP_PORT": "5001",
        "UNIFIED_MCP_HOST": "localhost"
      }
    }
  }
}

手动设定

Cursor在设置中添加：

{
  "mcp": {
    "servers": {
      "unified-mcp": {
        "command": "node",
        "args": ["/path/to/unified_mcp_server/dist/index.js"]
      }
    }
  }
}

📦 対応MCP

默认值MCP

  • 剧作家MCP -浏览器自动化测试

  • 浏览器MCP -浏览器导航

  • 上下文7 MCP -上下文管理内存

  • 顺序思维MCP -逻辑思维过程

可用的MCP（已禁用）

  • Figma MCP -设计文件访问
  • Serena MCP -查询处理功能

MCP添加方法

  1. src/config/mcps.ts 新的MCP添加定义：
newmcp: {
  name: 'newmcp',
  displayName: 'New MCP Server',
  npmPackage: '@org/mcp-server-package',
  githubRepo: 'https://github.com/org/mcp-server',
  command: ['npx', '@org/mcp-server-package'],
  protocol: 'stdio',
  enabled: true
}
  1. 重新启动服务器时会自动确认安装

🎯 提示优化

MCP改进自动选择提示的诀窍

集成MCP服务器最适合分析提示内容MCP选项卡页面上创建或编辑条目。

有效提示示例：

# Playwright MCP が選択される
"PlaywrightでGoogleのスクリーンショットを撮影してください"

# Browser MCP が選択される  
"このWebサイトのコンテンツを抽出してください"

# Context7 MCP が選択される
"この会話の内容をコンテキストに保存してください"

# Sequential Thinking MCP が選択される
"この問題を段階的に分析してください"

提示建议API

最佳MCP事先确认：

curl -X POST http://localhost:5001/suggest-mcp \
  -H "Content-Type: application/json" \
  -d '{"prompt": "ブラウザでテストを実行してください"}'

获取提示指南

curl http://localhost:5001/prompt-guide

有关详细的提示优化 MCP_PROMPT_GUIDE.md 来修改标记元素的显示属性。

🔧 设定

环境变数

UNIFIED_MCP_PORT=5001         # サーバーポート（デフォルト: 5001）
UNIFIED_MCP_HOST=localhost    # サーバーホスト（デフォルト: localhost）
LOG_LEVEL=info               # ログレベル（debug, info, warn, error）
INSTALL_TIMEOUT=300000       # インストールタイムアウト（ms）
MCP_START_TIMEOUT=30000      # MCP起動タイムアウト（ms）

配置文件

  • .unified_mcp_install_status.json -安装状态（自动生成）
  • .cursor/mcp_config.json - Cursor设定（自动生成）
  • unified_mcp.log -运行日志

📊 响应格式

所有MCP响应将自动添加元数据：

{
  "jsonrpc": "2.0",
  "id": "request-id",
  "result": {
    // 元のMCPレスポンス
  },
  "_meta": {
    "source": "figma",
    "githubRepo": "https://github.com/modelcontextprotocol/server-figma",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
}

🔍 故障排除

常见问题

Q: MCP未安装

# npmのグローバル設定を確認
npm config get prefix

# 手動でMCPをインストール
npm install -g @playwright/mcp
npm install -g @browsermcp/mcp
npm install -g @upstash/context7-mcp  
npm install -g @modelcontextprotocol/server-sequential-thinking

Q: 服务器未启动

# ポートが使用中かチェック
lsof -i :5001

# ログを確認
tail -f unified_mcp.log

Q: MCP服务器未响应

# ヘルスチェックを実行
yarn health

# 手動でMCPプロセスを確認
ps aux | grep @modelcontextprotocol

调试模式

# デバッグログ有効化
LOG_LEVEL=debug yarn dev

🤝 开发和定制

目录配置

src/
├── index.ts              # メインエントリーポイント
├── mcp/
│   ├── manager.ts        # MCPプロセス管理
│   ├── proxy.ts          # 統合プロキシサーバー
│   └── installer.ts      # 自動インストーラー
├── config/
│   ├── mcps.ts          # MCP設定定義
│   └── server.ts        # サーバー設定
├── utils/
│   ├── logger.ts        # ログ機能
│   └── config-generator.ts # 設定ファイル生成
└── types/
    └── mcp.ts           # 型定義

开发命令

yarn watch                # ファイル変更監視
yarn clean && yarn build  # クリーンビルド
yarn dev --help           # オプション確認

📄 许可证

MIT许可证

🔗 相关链接

相关 MCP