MCP Federation Core

MCP联合核心v2.2-生产套件🚀

    ](https://github.com/justmy2satoshis/mcp-federation-core) 

✅ 所有15个MCP均在v2.2.0版本中工作 -修复了内存和NPX包问题，保证所有MCP正确安装

15个生产就绪的模型上下文协议服务器的轻量级编排器，具有选择性数据库统一、有保证的数据保存和企业级功能。

🎯 什么是MCP联盟核心？

MCP Federation Core是一个轻量级的统一数据库系统，可实现15个不同模型上下文协议服务器之间的无缝通信。它为人工智能上下文管理提供了一个基础框架，允许MCP通过联邦架构共享数据、持久化信息和协作。

主要特点：

• 🎯 Olama自动检测：对所有Ollama型号（llama3.2、mistral、phi3等）的零配置支持
• 💰 节省95%的成本：具有API回退的自动本地模型优先级
• 🔄 统一数据库：所有MCP共享单个SQLite数据库
• 🌐 跨MCP通信：使用以下命令从任何MCP查询数据 from_mcp 参数
• ⚡ 轻量级：针对标准硬件进行了优化（最低4GB RAM）
• 🛠️ 专家角色系统：50个具有信心评分的专业人工智能专家角色
• 🧠 高级推理：思维链（CoT）和思维树（ToT）框架
• 🔌 REST API：通过端口3456进行外部集成
• 📦 简易安装：使用PowerShell安装程序设置一个命令

🏗️ 建筑

MCP联合核心是 精简编排层 为Claude Desktop安装和配置15台精心挑选的MCP服务器。与单体包不同，这个联盟：

• ✅ 从原始来源提取 （npm注册表+GitHub）
• ✅ 保持零捆绑代码 （仅限安装程序）
• ✅ 启用独立更新 根据MCP
• ✅ 实现选择性数据库统一 （节省40%的内存）

选择性数据库统一

15个MCP中只有5个需要持久存储。我们的选择性统一方法：

Unified Database Group (4 MCPs, 30MB total):
├── memory           - Conversation history
├── kimi-k2-code     - Code analysis cache
├── kimi-k2-heavy    - Processing results
└── rag-context      - Vector embeddings

Independent (1 MCP):
└── sqlite           - User's database interface

Stateless (10 MCPs):
└── No database required (API-based or filesystem operations)

优点：

• 与独立数据库相比，内存减少40%
• 有益的跨MCP数据共享
• 如果统一失败，那就彻底撤退
• 不修改原始存储库

📦 包括MCP（共15个）

自定义MCP（4）：

标准MCP（11）：

🚀 快速安装

先决条件

• Python 3.8+ （使用 python 在Windows上， python3 在macOS/Linux上）
• Node.js 18+ （用以下方式验证 node --version)
• Git （用以下方式验证 git --version)
• 克劳德桌面版 （必须先安装）
• Internet连接 用于下载软件包

安装步骤

选项1：全新安装

如果您是第一次安装：

Windows（PowerShell）

# Clone the repository
git clone https://github.com/justmy2satoshis/mcp-federation-core.git
cd mcp-federation-core

# Run the verbose installer for clear feedback
python FEDERATED-INSTALLER-UNIFIED-VERBOSE.py

# Or use the original installer
python FEDERATED-INSTALLER-UNIFIED.py

macOS/Linux

# Clone the repository
git clone https://github.com/justmy2satoshis/mcp-federation-core.git
cd mcp-federation-core

# Run the verbose installer for clear feedback
python3 FEDERATED-INSTALLER-UNIFIED-VERBOSE.py

# Or use the original installer
python3 FEDERATED-INSTALLER-UNIFIED.py

选项2：更新现有安装

如果您已经克隆了存储库：

# Navigate to your existing directory
cd mcp-federation-core

# Pull latest updates
git pull origin main

# Run the installer
python FEDERATED-INSTALLER-UNIFIED-VERBOSE.py  # Windows
python3 FEDERATED-INSTALLER-UNIFIED-VERBOSE.py # macOS/Linux

📊 安装过程中会发生什么

增强的安装程序将显示：

1. 创业横幅 -系统信息和安装路径
2. 先决条件检查 -验证Python、Node.js、npm和git
3. 进度指标 -每个MCP的\[1/15\]、\[2/15\]等
4. 实时反馈 - ✅ 为了成功，❌ 对于故障，→ 对于正在进行的
5. 安装摘要 -成功/失败计数和下一步行动

输出示例：

======================================================================
 MCP FEDERATION CORE INSTALLER v2.0.0
======================================================================
 Installing to: C:\Users\YourName\mcp-servers
 Python: 3.11.5
 Platform: Windows 10
======================================================================

🔍 Checking prerequisites...
  ✅ python: Python 3.11.5
  ✅ node: v20.10.0
  ✅ npm: 10.2.5
  ✅ git: git version 2.42.0

[1/15] Installing sequential-thinking
  📦 Type: NPM Package
  📦 Package: mcp-sequential-thinking
  → Installing from npm registry...
  ✅ Successfully installed in 3.2s

[2/15] Installing expert-role-prompt
  🔗 Type: GitHub Repository
  🔗 Source: https://github.com/justmy2satoshis/expert-role-prompt-mcp.git
  → Cloning repository...
  ✅ Repository cloned successfully

⚠️ 故障排除

如果安装程序静默运行（无输出）：

• 确保你使用了正确的Python命令(python 对比 python3)
• 尝试使用无缓冲输出运行： python -u FEDERATED-INSTALLER-UNIFIED.py
• 使用详细版本： FEDERATED-INSTALLER-UNIFIED-VERBOSE.py

如果您看到“不在mcp联盟核心目录中”：

• 确保您位于克隆的存储库目录中
• 与核对 dir （Windows）或 ls （macOS/Linux）
• 安装程序文件应在当前目录中可见

📦 可用安装程序

🛡️ 安装人员做什么（安全）

1. 创建备份 您现有的Claude Desktop配置
2. 创建安装清单 跟踪安装的内容
3. 扫描现有MCP 识别现有安装与新安装
4. 安装11个npm包 全局使用正确的包名称
5. 克隆4个GitHub存储库 用于自定义MCP
6. 配置统一数据库 实现最佳性能（4 MCP）
7. 合并配置 同时保留现有的MCP
8. 验证安装 并提供详细的总结

安装什么

Your System:
├── Global npm packages (11 MCPs)
├── ~/.mcp-federation/
│   ├── github-mcps/        # Cloned repositories
│   ├── databases/          # Unified database
│   └── wrappers/          # Database path injectors
└── Claude Desktop Config   # Auto-configured

🔧 配置

数据库体系结构

联盟实施 选择性统一 -只有受益于共享数据的MCP才使用统一数据库：

# Automatically configured by installer
Unified Database MCPs:
- memory: Share conversation context
- kimi-k2-code-context: Share code analysis
- kimi-k2-heavy-processor: Share processing cache
- rag-context: Share embeddings

Independent MCPs:
- sqlite: Your database operations
- 10 others: Stateless operations

Claude桌面集成

安装程序会自动配置Claude Desktop。手动配置可以通过编辑完成：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

REST API访问

专家级批量MCP包括一个REST API服务器：

# Start REST API server (port 3456)
node mcp-servers/expert-role-prompt/rest-api-server.js

# Example API call
curl http://localhost:3456/api/nominate-expert \
  -H "Content-Type: application/json" \
  -d '{"task": "analyze Python code"}'

📊 性能基准

标准硬件（32核，61GB RAM）负载测试结果：

响应时间：

• 数据库写入：平均5.67ms
• 数据库读取：平均0.03毫秒
• 跨MCP查询：平均0.03毫秒
• MCP启动：每个MCP约500ms

资源使用情况：

• 空闲内存：21 MB
• 活动存储器：200-400MB
• CPU（空闲）: 0.4%
• CPU（活动）: 15-25%
• 数据库大小：16KB（随使用量增长）

并行操作：

• 最大并行MCP：15（全部运行）
• 请求/秒：50+持续

内存使用情况比较

🗑️ 安全卸载

🛡️ 保存保证：仅删除由联盟安装的MCP

# Safe uninstaller (recommended - uses installation manifest)
python uninstaller-clean.py

# Original uninstaller (still works)
python uninstaller.py

卸载程序的功能（安全）

1. 读取安装清单 确定哪些可以安全移除
2. 仅删除MCP 该联盟新安装的
3. 保留已有的MCP 即使他们有联盟名称
4. 保留所有自定义MCP 完全未受影响
5. 可选清理 联邦数据文件（用户选择）
6. 创建安全备份 在做出任何更改之前

卸载选项

• 选择性去除：只有联盟安装了MCP
• 保留用户MCP：保留所有预先存在的和定制的MCP
• 可选数据清理：选择是否删除联盟数据库
• 备份创建：更改前自动安全备份

🔍 故障排除

常见问题

❌ 运行安装程序时出现“找不到文件”错误

# Make sure you're in the repository root directory
pwd  # Should show .../mcp-federation-core
ls   # Should show FEDERATED-INSTALLER-UNIFIED.py

# If not in the right directory:
cd mcp-federation-core

❌ 安装失败，出现npm错误

# Run the diagnostic tool first
python diagnose_mcp_issues.py

# Check your environment
node --version  # Should be 18+
npm --version
python --version  # Should be 3.8+

# Update npm if needed
npm install -g npm@latest

❌ MCP未出现在Claude Desktop中

1. 完全重新启动克劳德桌面 （不仅仅是刷新）
2. 检查配置文件是否存在于：

- 窗户： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 验证JSON语法是否有效（使用JSONLint.com）

❌ 某些MCP需要API密钥 安装后将这些添加到配置文件中：

{
  "mcpServers": {
    "github-manager": {
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "web-search": {
      "env": {
        "BRAVE_API_KEY": "your_brave_api_key_here"
      }
    },
    "perplexity": {
      "env": {
        "PERPLEXITY_API_KEY": "pplx-your_key_here"
      }
    },
    "converse": {
      "env": {
        "OPENAI_API_KEY": "sk-your_key_here",
        "GOOGLE_API_KEY": "AIza_your_key_here"
      }
    }
  }
}

❌ Python/Node.js版本问题

• 视窗：使用 python （不是 python3)
• macOS/Linux：使用 python3 （不是 python)
• 确保Node.js的版本为18或更高
• 一些MCP需要Python 3.8+

❌ “权限被拒绝”错误

# On macOS/Linux, you might need:
sudo npm install -g 

# Or fix npm permissions:
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

📚 文档

专家角色（50个可用）：

• 软件工程师（前端、后端、全栈）
• AI/ML专家（数据科学家、ML工程师）
• DevOps和基础设施（云、安全、SRE）
• 产品与设计（PM、UX、UI）
• 商业与战略（分析师、顾问）
• 40多个专业角色

推理框架：

• 思维链（CoT）：逐步逻辑推理
• 思想之树（ToT）：探索解决方案的分支
• 信心评分：与基本原理匹配0-100%

更新机制

# Update all npm MCPs
npm update -g @modelcontextprotocol/server-*

# Update specific GitHub MCP
cd ~/.mcp-federation/github-mcps/kimi-k2-heavy-processor-mcp
git pull origin main

# Or use the updater
python update-federation.py

🏛️ 建筑细部

为什么是联邦，而不是捆绑？

传统方法直接捆绑MCP代码。我们选择联盟是因为：

1. 可维护性：从原始来源获取更新
2. 灵活性：无缝混合npm和GitHub源代码
3. 演出：在重要的地方进行选择性优化
4. 兼容性：无需分叉或修改

数据库统一策略

graph TD
    A[MCP Request] --> B{Needs Database?}
    B -->|No| C[Direct Execution]
    B -->|Yes| D{Unified Group?}
    D -->|Yes| E[Unified DB + Namespace]
    D -->|No| F[Independent DB]
    E --> G[Wrapper Script]
    G --> H[Original MCP]

安装流程

graph LR
    A[Start] --> B[Check Prerequisites]
    B --> C[Install npm MCPs]
    C --> D[Clone GitHub MCPs]
    D --> E[Setup Unified DB]
    E --> F[Create Wrappers]
    F --> G[Configure Claude]
    G --> H[Verify]

统一数据库架构：

CREATE TABLE context (
    id TEXT PRIMARY KEY,
    mcp_source TEXT NOT NULL,
    data TEXT NOT NULL,
    metadata TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    expires_at TIMESTAMP,
    ttl INTEGER
);

跨MCP通信：

# Store data from one MCP
store_context(key="analysis_result", data=result, mcp_source="code-context")

# Retrieve from another MCP
data = retrieve_context(key="analysis_result", from_mcp="code-context")

# Query across all MCPs
all_data = retrieve_context(key="*", from_mcp="*")

🧪 测试

运行附带的测试套件以验证您的安装：

# Test cross-MCP communication
python test_mcp_persistence.py

# Check database connectivity
python check_mcp_db.py

# Run performance benchmark
python benchmark_mcp_performance.py

# Diagnostic tool to test all MCPs
python verify_mcps.py

📈 项目状态

当前版本（v2.0.0）

• ✅ 所有15台MCP均正常工作 -100%功能
• ✅ 专家角色体系 -50个专业角色
• ✅ Ollama自动检测 -节省80-95%的成本
• ✅ 高级推理 -CoT和ToT框架
• ✅ 目录嵌套防止 -不再有三重嵌套文件夹
• ✅ 完全卸载 -现在删除所有工件，而不仅仅是配置
• ✅ 已验证MCP命令 -所有软件包都针对工作配置进行了测试
• ✅ 安装清单跟踪 -防止卸载过程中数据丢失
• ✅ 选择性数据库统一 -4个MCP可节省40%的内存
• ✅ 包括诊断工具 -verify_mcps.py测试所有MCP
• ✅ Windows/macOS/Linux支持 -跨平台兼容性
• ✅ 全面的故障排除指南 -明确的解决步骤

最近修复

• ✅ v2.0.0版本：具有企业级功能的生产套件
• ✅ v1.1.0：Converse以Ollama为优先
• ✅ v0.1.5：converse增强版现在正确使用Python server.py
• ✅ v0.1.4：修复了创建三重嵌套文件夹的目录嵌套错误
• ✅ v0.1.4：修复了导致警告三角形的不正确的npm包
• ✅ v0.1.4：卸载程序现在完全删除所有文件和目录

🚀 路线图

当前版本（2.0.0-生产套件）：

• ✅ 15个具有统一数据库的MCP
• ✅ 跨MCP通信
• ✅ 具有50个专业角色的专家角色系统
• ✅ REST API集成
• ✅ Ollama自动检测和本地模型优先级
• ✅ 高级推理框架（CoT、ToT）
• ✅ 生产就绪的安装程序和卸载程序

即将推出（2.1.0）：

• 🔄 RAG Anything与适当的Python SDK集成
• 🔄 附加矢量搜索功能
• 🔄 增强的web仪表板
• 🔄 性能监控工具

未来（3.0.0-企业版）：

• 🔄 30+MCP，包括高级AI/ML
• 🔄 企业身份验证（OAuth、SAML）
• 🔄 云同步
• 🔄 高级工作流自动化
• 🔄 GPU加速支持

🤝 贡献

我们欢迎捐款！关键领域：

1. 新MCP集成：提出高价值的MCP
2. 性能优化：进一步提高内存/速度
3. 跨平台测试：尤其是Linux变体
4. 文档：教程和示例

看 贡献.md 作为指导方针。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 相关项目

• 专家角色提示 -独立专家角色MCP
• 克劳德桌面版 -MCP集成所需
• MCP规范 -MCP官方文件

🙏 致谢

• Anthropic 克劳德和MCP
• 模型上下文协议 社区
• MCP维护人员
• 早期采用者和测试人员

📞 支持

• 问题:
• 讨论:
• 电子邮件: notyourbuddyfriend2@protonmail.com
• 文档: 维基

______________________________________________________________________

内置于❤️ 作者：justmy2satoshis

🚀 准备好开始了吗？

在2分钟内安装MCP联合核心v2.0.0：

git clone https://github.com/justmy2satoshis/mcp-federation-core.git
cd mcp-federation-core
python FEDERATED-INSTALLER-UNIFIED.py  # Windows
# OR
python3 FEDERATED-INSTALLER-UNIFIED.py # macOS/Linux

MCP联合核心v2.0.0 -Claude Desktop的生产就绪编排。 ✅ 所有15个MCP均正常工作-100%功能正常！