Nexus Hub

🚀 NexusHub

Claude AI工具的统一MCP服务器

](https://github.com/webdevtodayjason/NexusHub) ](https://nodejs.org)  ](https://www.docker.com/) 

A powerful bridge between Claude AI and external services via Model Context Protocol.

Enhance Claude Code with filesystem access, database operations, vector search, GitHub integration, and more.

演示 • 文档 • 报告Bug • 请求功能

______________________________________________________________________

✨ 特性

• 📡 双接口 -支持HTTP和stdio MCP协议
• 💅 现代仪表板 -美观的协议设计系统管理界面，默认为暗模式
• 🔌 综合服务 -组合多个MCP服务器（内存、GitHub、Brave Search）
• 🔍 矢量数据库 -文档摄取和语义搜索功能
• 🔑 API管理 -安全地管理API密钥和服务配置
• 🐳 Docker集成 -使用Docker和Docker Compose轻松部署
• 📋 高级提示 -用于有效AI交互的预配置提示
• 🔄 实时状态 -监控所有连接服务的运行状况

The elegant NexusHub dashboard interface with Protocol design system

🏛️ 建筑

NexusHub使用Node.js后端，Express用于HTTP接口，原生stdio用于CLI接口。服务器集成了几个关键服务：

┌─────────────────────────────────────────────────────┐
│                  Claude Desktop                     │
└───────────┬─────────────────┬───────────┬───────────┘
            │                 │           │
            ▼                 ▼           ▼           
┌───────────────────┐ ┌─────────────┐ ┌─────────────┐ 
│    NexusHub MCP   │ │ Memory MCP  │ │ GitHub MCP  │ 
│       Server      │ │   Server    │ │   Server    │ 
└─────────┬─────────┘ └─────────────┘ └─────────────┘ 
          │                  ▲                ▲        
          ▼                  │                │        
┌─────────────────┐          │                │        
│  Vector Store   │          │                │        
└─────────────────┘          │                │        
          │                  │                │        
          ▼                  │                │        
┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Filesystem API  │ │ Database API│ │   Docker API    │
└─────────────────┘ └─────────────┘ └─────────────────┘

🛠️ 可用工具

NexusHub为Claude AI提供以下工具：

🚀 入门指南

先决条件

• Docker和Docker Compose
• Node.js 18+
• Python 3.8+（用于向量嵌入）

安装

1. 克隆存储库：

   git clone https://github.com/webdevtodayjason/NexusHub.git
   cd NexusHub

1. 设置环境变量：

   cp .env.example .env
   # Edit .env file with your API keys

1. 启动服务：

   docker-compose up -d

1. 访问仪表板：

打开 http://localhost:8001/dashboard 在您的浏览器中

Claude桌面配置

NexusHub支持与Claude Desktop的两种不同集成方法：

1.HTTP模式

此模式通过HTTP端点连接到NexusHub。添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "nexushub": {
      "name": "NexusHub MCP Server",
      "description": "Centralized MCP server with multiple capabilities",
      "url": "http://localhost:8001/mcp",
      "enabled": true
    }
  }
}

2.STDIO模式（推荐）

此模式使用直接进程通信以获得更好的性能和可靠性。它要求NexusHub代码在本地可用：

1. 准备包装脚本：

   # Make the wrapper script executable
   chmod +x /path/to/nexushub/nexushub-mcp.sh
   chmod +x /path/to/nexushub/src/mcp/adapters/stdio-wrapper.js
   chmod +x /path/to/nexushub/src/mcp/stdio-adapter.js

1. 添加到您的 claude_desktop_config.json:

   {
     "mcpServers": {
       "nexushub": {
         "name": "NexusHub MCP Server",
         "description": "Centralized MCP server with multiple capabilities",
         "command": "/path/to/nexushub/nexushub-mcp.sh",
         "enabled": true
       },
       "brave-search": {
         "name": "Brave Search MCP",
         "description": "Provides web search capabilities via Brave Search API.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_brave_search", "node", "dist/index.js"],
         "enabled": true
       },
       "github": {
         "name": "GitHub MCP",
         "description": "Provides GitHub repository interaction.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_github", "node", "dist/index.js"],
         "enabled": true
       },
       "memory": {
         "name": "Memory MCP",
         "description": "Persistent knowledge graph memory.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_memory", "node", "dist/index.js"],
         "enabled": true
       }
     }
   }

注： 替换 /path/to/nexushub 使用您的实际NexusHub安装路径。

Docker容器

在启动Claude Desktop之前，请确保所有Docker容器都在运行：

cd /path/to/nexushub
docker-compose up -d

这将启动所有必需的MCP服务器：

• NexusHub（带文件系统、数据库、Docker工具的主服务器）
• Brave Search MCP（网络搜索功能）
• GitHub MCP（存储库交互）
• 存储器MCP（知识图/持久存储器）

💡 示例用法

以下是一些如何将NexusHub与Claude AI结合使用的示例：

文件操作

Please use fs_list_files to show me all the JavaScript files in the src directory, 
then read the content of any interesting files you find.

数据库查询

Can you use db_execute_query to find all users in the database who joined 
in the last month and have the "admin" role?

矢量搜索

Please use vector_search to find documentation related to "authentication flow" 
and summarize the key points.

组合工具

First, use brave_web_search to find the latest best practices for React error boundaries. 
Then, use fs_read_file to examine our current implementation in ErrorBoundary.jsx, 
and suggest improvements based on what you found.

🧩 如何添加自己的工具

您可以通过向NexusHub添加新的工具定义来使用自定义工具扩展NexusHub /src/mcp/tools/ 目录：

// src/mcp/tools/my-custom-tools.js

export function getToolDefinitions() {
  return {
    my_custom_tool: {
      name: 'my_custom_tool',
      description: 'Description of what the tool does.',
      inputSchema: {
        type: 'object',
        properties: {
          param1: {
            type: 'string',
            description: 'Description of parameter 1'
          }
          // Add more parameters as needed
        },
        required: ['param1']
      }
    }
  };
}

// Tool implementation
export async function myCustomTool(param1) {
  // Your custom tool logic here
  return { result: 'Success!' };
}

然后将工具添加到 /src/mcp/tools/index.js 和 /src/mcp/tools/handler.js.

🔄 地方发展

1. 安装依赖项：

   npm install

1. 在开发模式下运行：

   npm run dev

1. 对于stdio模式测试：

   npm run stdio

🧪 运行测试

# Run all tests
npm test

# Run specific test suite
npm test -- --grep "API Keys"

🔧 故障排除

Claude桌面集成问题

1. 启动Claude Desktop时出现“意外令牌”错误：

- 确保您的包装脚本具有适当的权限： chmod +x nexushub-mcp.sh - 验证所有脚本是否正确过滤非JSON输出 - 检查中的日志文件 /tmp/nexushub-debug-*.log 详见

1. MCP服务器未加载或工具未出现：

- 确保Docker容器正在运行： docker ps | grep mcp - 检查容器日志： docker logs mcp_brave_search - 验证Claude Desktop配置是否具有正确的路径/命令 - 更改后尝试重新启动Claude Desktop

1. Docker容器问题：

- 如果Docker日志太大，请清除它们： docker system prune - 重新启动容器： docker-compose restart - 检查端口冲突： lsof -i :8001

常见错误消息

📚 文档

工具开发指南

• 快速入门指南 -5分钟后起床跑步
• 工具开发指南 -创建工具的综合指南
• AI工具创建提示 -优化了人工智能辅助工具创建的提示

集成指南

• Claude桌面集成 -将NexusHub连接到克劳德桌面
• Claude CLI集成 -使用NexusHub和Claude CLI

MCP资源

• 模型上下文协议官方网站
• Claude桌面用户的MCP快速入门
• Claude代码文档

有关完整文档，请访问 NexusHub维基.

🤝 贡献

贡献使开源社区成为一个学习、激励和创造的好地方。你所做的任何贡献都是 非常感谢.

1. 分叉项目
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支机构(git push origin feature/AmazingFeature)
5. 打开拉取请求

📝 许可证

根据MIT许可证分发。看 LICENSE 了解更多信息。

👨‍💻 作者

杰森·布拉舍尔

🙏 致谢

• 克劳德 AI -因为惊人的人工智能能力
• 模型上下文协议 -协议规范
• 协议设计系统 -用于现代UI设计语言
• 顺风CSS -对于实用程序优先的CSS框架

______________________________________________________________________

Built with ❤️ by Jason Brashear