Fusion MCP集线器
    
配套工具：
](https://www.npmjs.com/package/fusion-mcp-cli) ](https://www.npmjs.com/package/fusion-mcp-proxy)
______________________________________________________________________
🎯 问题
为GitHub安装MCP服务器。太棒了但是等等，它随之而来 50+工具你只需要3个。
现在，LLM的系统提示中充斥着47个不必要的工具描述。 结果？
- 💸 API成本更高（代币不是免费的）
- 🤯 更多的幻觉（太多的选项会混淆模型）
- 🐌 响应速度较慢（处理开销）
- 😤 精度更差（信号在噪声中丢失）
每一个。单身。请求。
✨ 解决方案
Fusion MCP集线器 允许您使用以下工具构建自定义MCP服务器 *仅* 你真正需要的工具。
在16台服务器上浏览300多种工具。单击您想要的。下载一个精益、生产就绪的软件包。完成。
需要Jira问题跟踪+GitHub PR吗？从Atlassian获取2个工具，从GitHub获取2个。 4个工具，而不是60+。 你的法学硕士会感谢你的。
想要AI推荐吗？用简单的英语描述你的工作流程——我们将使用语义搜索和多因素评分推荐完美的工具组合。
🚀 现场试试: fusion-mcp-hub.vercel.app
______________________________________________________________________
🛠️ 完整的工具链
Fusion MCP Hub是一个 完整的生态系统 用于管理MCP服务器：
🌐 Web Hub（此存储库）
用于发现、组合和测试MCP服务器的主要平台。
- 在16+台服务器上浏览300+个工具
- 创建自定义服务器组合
- 实时使用AI代理进行测试
- 部署前验证配置
📦 融合MCP命令行界面
用于在本地安装和管理自定义服务器的命令行工具。
# Install globally
npm install -g fusion-mcp-cli
# Login to your workspace
npx fusion-mcp-cli auth login -u https://fusion-mcp-hub.vercel.app
# Pull a custom server from the hub
npx fusion-mcp-cli server pull my-custom-server
# Auto-configure Claude Desktop / Bob IDE / Copilot Chat
npx fusion-mcp-cli config set --client claude
# Install community servers from the hub
npx fusion-mcp-cli server install github-server主要特点：
- 🔄 将自定义服务器拉入/推入工作区
- ⚙️ 自动配置Claude桌面、Bob IDE、Copilot聊天
- 📦 从库中安装预构建的服务器
- 🔧 管理项目级和全局配置
🔌 融合MCP代理
WebSocket代理，用于从web游乐场测试本地stdio MCP服务器。
# Install globally
npm install -g fusion-mcp-proxy
# Start proxy (auto-detects your mcp.json from Claude/Bob/Copilot)
fmcp-proxy start
# Or specify a custom config
fmcp-proxy start --config ./my-mcp-config.json主要特点：
- 🌉 将浏览器客户端连接到本地stdio服务器
- 🤖 运行具有直接MCP服务器访问权限的AI代理（消除了时间问题）
- 🔍 自动检测来自Claude、Bob或Copilot的mcp.json
- 📡 代理执行的实时流式传输
使用案例：
- 在web游乐场测试本地stdio服务器
- 运行需要同步工具执行的ReAct代理
- 在开发过程中调试MCP服务器
______________________________________________________________________
🌟 主要特点
🔧 自定义服务器组成
解决Token Bloat问题：仅使用您需要的工具创建精简的专用MCP服务器。
问题：完整的MCP服务器暴露了20-50多种工具，用不必要的信息淹没了LLM上下文。这增加了成本，导致幻觉，并降低了准确性。
解决方案：通过从多个服务器中选择特定工具来组合自定义服务器：
- 手动选择：在16+台服务器上浏览300+个工具，并精确选择您需要的工具
- 基于人工智能的推荐：用简单的英语描述你的工作流程，获得智能工具建议
- 可视化工作流生成器：请参阅按源组织的服务器依赖关系和工具关系
- 一键下载：作为完整的、可生产的NPM包出口
- CLI集成：直接通过安装和配置自定义服务器
fusion-mcp-cli
示例：需要Jira+GitHub吗？不要从两个服务器加载40多个工具。只需以下内容即可构建自定义服务器：
jira_get_issue,jira_search_issues（Atlassian服务器提供的2个工具）github_create_pull_request,github_list_commits（来自GitHub服务器的2个工具）
结果： 4个重点工具 而不是40+不必要的=更低的成本，更好的准确性。
🎨 智能构图（AI驱动模式）
通过智能建议加速自定义服务器的创建：
- 自然语言意图：用简单的英语描述你的工作流程
- 混合搜索：矢量嵌入+关键字匹配，用于智能工具发现
- 多因素评分：意图对齐、模式匹配和语义相似性
- 置信度得分：透明地查看每项建议背后的推理
🎮 互动游乐场
实时测试MCP服务器和AI代理：
- 多模型支持：OpenAI（GPT-4、GPT-3.5）、Anthropic（Claude 3.5 Sonnet）、IBM Watsonx
- 三种执行模式:
- 浏览器模式：直接浏览器到服务器连接（HTTP/WebSocket） - 代理模式：通过WebSocket代理连接到本地stdio服务器 - 代理模式：在代理上运行LangGraph ReAct代理，并同步执行工具
- 实时流媒体：查看代理推理、工具调用和结果
- 服务器管理：同时添加、配置和测试多个服务器
🔍 配置验证器
部署前验证MCP配置：
- 多种输入法：上传文件、拖放或粘贴JSON
- 实时验证：配置问题的即时反馈
- 智能检测：识别缺失或配置错误的服务器
- 自动修复建议：即用型配置片段
- 多客户端支持：Claude Desktop、Bob IDE和Copilot聊天配置
📦 服务器库
探索完整的MCP生态系统：
- 16+预装服务器：针对不同用例的专用服务器
- 300+工具：涵盖所有类别的综合工具库
- 类别筛选：按开发、业务、数据、人工智能等浏览
- 详细文件：每个服务器和工具的完整指南
👥 工作空间管理
按项目或团队组织工作：
- 多个工作区：不同项目的独立环境
- 自定义服务器存储：将组合的服务器存储在工作区中
- 团队协作：与团队成员共享配置和服务器
- CLI集成：通过命令行工具拉取/推送服务器
______________________________________________________________________
🚀 入门指南
技术栈
Web应用程序：
- Next.js 15.5.6与应用路由器
- TypeScript 5
- 带有shadcn/ui的顺风CSS v4
- MongoDB用于服务器元数据
- LanceDB+Xenova Transformers用于语义搜索
- LangChain+LangGraph用于代理编排
先决条件
- Node.js：18.x或更高
- MongoDB：4.x或更高（本地或Atlas）
- API密钥 （可选，用于AI功能）：
- OpenAI API密钥 - 无烟煤API键 - IBM Watsonx证书
安装
- 克隆存储库:
git clone https://github.com/KirtiJha/fusion-mcp-hub.git
cd fusion-mcp-hub- 安装依赖项:
npm install- 设置环境变量:
cp .env.production.example .env.local在中配置 .env.local:
# MongoDB
MONGODB_URI=mongodb://localhost:27017/mcp-hub
MONGODB_DB_NAME=mcp-hub
# NextAuth (generate with: openssl rand -base64 32)
NEXTAUTH_SECRET=your-secret-key-here
NEXTAUTH_URL=http://localhost:3000
# AI Provider API Keys (optional)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
WATSONX_API_KEY=your-watsonx-key
WATSONX_PROJECT_ID=your-project-id- 启动开发服务器:
npm run dev- 打开浏览器: http://localhost:3000
______________________________________________________________________
💡 核心功能
自定义服务器创建
手动合成工作流程:
- 浏览服务器库:
- 探索不同类别的16+MCP服务器 - 按开发、业务、数据、人工智能等筛选 - 查看每台服务器的详细工具文档
- 选择工具:
- 单击多个服务器中的单个工具 - 构建您的自定义工具集 - 查看按源服务器组织的所选工具的实时预览
- 下载和部署:
- 导出为生产就绪的NPM包 - 本地安装： npm install ./my-custom-server.tgz - 配置为： npx fusion-mcp-cli server install my-custom-server - 在Claude Desktop、Bob IDE或任何MCP客户端中使用
智能构图工作流程（人工智能驱动）:
- 描述你的意图:
"I need to analyze Jira issues, fetch related Confluence pages,
and generate a summary report"- AI分析:
- 将意图分解为任务（获取、分析、生成） - 确定所需的操作（查询、读取、写入） - 提取关键字和实体
- 混合搜索:
- 基于Xenova Transformers嵌入的矢量搜索 - 关键字匹配的全文搜索（BM25） - 互惠排名融合（RRF）用于结果重新排名
- 多因素评分:
- 意图对齐：与任务描述的语义相似性 - 模式匹配：常见的工作流模式 - 工具兼容性：特定于任务的功能 - 信心评分：透明的综合评分
- 可视化工作流:
- 查看按服务器组织的推荐工具 - 审查信心评分和推理 - 自定义工具选择 - 下载生产就绪配置
游乐场执行模式
浏览器模式
- 连接到已部署的HTTP/WebSocket MCP服务器
- 最适合：测试远程/生产服务器
- 限制：无法访问本地stdio服务器
代理模式
- 连接到代理，代理生成本地stdio服务器
- 最适合：测试本地开发服务器
- 限制：异步工具执行可能会导致代理问题
代理模式（推荐）
- 整个代理在具有直接服务器访问权限的代理上运行
- 同步工具执行消除了时间问题
- 最适合：使用本地服务器进行可靠的代理测试
- 功能：实时流式传输代理推理和工具结果
______________________________________________________________________
🏗️ 建筑
项目结构
fusion-mcp-hub/
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── api/ # API routes
│ │ │ ├── composition/ # Smart composition endpoints
│ │ │ ├── vector-search/ # Vector search & reindex
│ │ │ ├── playground/ # Playground agent execution
│ │ │ └── auth/ # Authentication
│ │ ├── composition/ # Composition page
│ │ ├── playground/ # Interactive playground
│ │ ├── servers/ # Server gallery
│ │ └── validate/ # Configuration validator
│ ├── components/ # React components
│ │ ├── composition/ # Composition UI
│ │ ├── playground/ # Playground UI
│ │ └── ui/ # shadcn/ui components
│ ├── lib/ # Utilities and services
│ ├── services/ # Business logic
│ │ ├── workflowAnalysisService.ts # Intent analysis
│ │ ├── vectorSearchService.ts # Vector search
│ │ └── toolCompatibilityService.ts # Pattern matching
│ └── types/ # TypeScript types
├── bridges/ # MCP WebSocket bridge scripts
├── scripts/
│ └── deployment/ # Deployment utilities
├── public/ # Static assets
└── docs/ # Documentation技术栈
前端：Next.js 15.5.6，TypeScript 5，顺风CSS v4，shadcn/ui，Framer Motion
后端：Next.js API路由、MongoDB、LanceDB、Redis（可选）
AI/ML：LangChain、LangGraph、Xenova Transformers、OpenAI/Anthropic/Watsonx模型
实时：WebSocket、服务器发送事件（SSE）、stdio网桥的代理服务器
______________________________________________________________________
🛠️ 发展
地方发展
# Install dependencies
npm install
# Start dev server with hot reload
npm run dev
# Run linter
npm run lint
# Build for production
npm run build
# Start production server
npm start矢量搜索
无服务器环境中首次请求时矢量搜索自动索引：
# Trigger reindex
curl -X POST http://localhost:3000/api/vector-search/reindex
# Check index stats
curl http://localhost:3000/api/vector-search______________________________________________________________________
🚢 部署
Vercel（推荐）
- 推送到GitHub
- 在Vercel中导入存储库
- 从配置环境变量
.env.production.example - 部署！
无服务器注意事项
- MongoDB：使用MongoDB Atlas（无服务器需要）
- 矢量搜索：LanceDB使用临时
/tmp存储，冷启动时自动重新索引 - 函数大小：使用LanceDB的路线可能超过250MB限制（请参阅
next.config.ts优化）
______________________________________________________________________
📖 文档
- 高级推荐系统 -深入了解基于人工智能的推荐
- Vercel部署指南 -故障排除和优化
______________________________________________________________________
🤝 贡献
我们欢迎捐款！无论您是在修复错误、添加功能还是改进文档，我们都会感谢您的帮助。
请阅读我们的 贡献指南 开始吧。
快速开始
- 分叉存储库
- 创建要素分支：
git checkout -b feature/amazing-feature - 进行更改并提交：
git commit -m 'feat: add amazing feature' - 推你的叉子：
git push origin feature/amazing-feature - 打开拉取请求
开发指南
- 遵循TypeScript和React的最佳实践
- 写有意义的提交消息(约定式提交)
- 为新功能添加测试
- 根据需要更新文档
______________________________________________________________________
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
📜 行为准则
我们致力于为每个人提供热情和包容的体验。请阅读我们的 行为准则.
______________________________________________________________________
🙏 致谢
- 内置于 Next.js, TypeScript，以及 Tailwind CSS
- UI组件来自 shadcn/ui
- 矢量搜索由 LanceDB 和 Xenova变压器
- 灵感来自神奇 模型上下文协议 社区
______________________________________________________________________
💬 社区与支持
______________________________________________________________________
内置于❤️ MCP社区