MCP 服务器

🚀 NexusHub

NexusHub 是一个强大的模型上下文协议 (MCP) 服务器，它充当 AI 工作流程和工具集成的中心连接点。

webdevtodayjason

开发者工具

访问服务器

README

🚀 NexusHub

用于 Claude AI 工具的统一 MCP 服务器

<p> <strong>通过模型上下文协议，在 Claude AI 和外部服务之间建立强大的桥梁。</strong><br> 通过文件系统访问、数据库操作、向量搜索、GitHub 集成等功能增强 Claude 代码。 </p>

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

</div>

✨ 功能

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

<div align="center"> <br> <img src="https://raw.githubusercontent.com/webdevtodayjason/NexusHub/main/public/dashboard-screenshot.png" alt="NexusHub Dashboard" width="800" /> <br> <em>优雅的 NexusHub 仪表板界面，采用 Protocol 设计系统</em> <br> </div>

🏛️ 架构

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 提供以下工具：

类别	工具	描述
文件系统	`fs_list_files`	列出目录中的文件
	`fs_read_file`	读取文件内容
	`fs_write_file`	写入文件
数据库	`db_execute_query`	执行只读 SQL 查询
	`db_list_tables`	列出数据库中的所有表
	`db_describe_table`	获取表结构
	`db_insert_data`	将数据插入到表中
Docker	`docker_list_containers`	列出 Docker 容器
	`docker_start_container`	启动容器
	`docker_stop_container`	停止容器
	`docker_get_container_logs`	获取容器日志
搜索	`serper_search`	通过 Serper API 执行网络搜索
向量数据库	`ingest_docs`	将文档摄取到向量存储中
	`vector_search`	搜索相似的文档

🚀 快速开始

前提条件

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

安装

克隆存储库：

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

设置环境变量：

cp .env.example .env
# 使用您的 API 密钥编辑 .env 文件

启动服务：
```
docker-compose up -d
```
访问仪表板： 在浏览器中打开 http://localhost:8001/dashboard

Claude Desktop 的配置

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

1. HTTP 模式

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

{
  "mcpServers": {
    "nexushub": {
      "name": "NexusHub MCP Server",
      "description": "具有多种功能的集中式 MCP 服务器",
      "url": "http://localhost:8001/mcp",
      "enabled": true
    }
  }
}

2. STDIO 模式（推荐）

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

准备包装器脚本：

# 使包装器脚本可执行
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

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "nexushub": {
      "name": "NexusHub MCP Server",
      "description": "具有多种功能的集中式 MCP 服务器",
      "command": "/path/to/nexushub/nexushub-mcp.sh",
      "enabled": true
    },
    "brave-search": {
      "name": "Brave Search MCP",
      "description": "通过 Brave Search API 提供网络搜索功能。",
      "command": "docker",
      "args": ["exec", "-i", "mcp_brave_search", "node", "dist/index.js"],
      "enabled": true
    },
    "github": {
      "name": "GitHub MCP",
      "description": "提供 GitHub 存储库交互。",
      "command": "docker",
      "args": ["exec", "-i", "mcp_github", "node", "dist/index.js"],
      "enabled": true
    },
    "memory": {
      "name": "Memory MCP",
      "description": "持久知识图谱内存。",
      "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（存储库交互）
Memory MCP（知识图谱/持久内存）

💡 使用示例

以下是一些将 NexusHub 与 Claude AI 一起使用的示例：

文件操作

请使用 fs_list_files 显示 src 目录中的所有 JavaScript 文件，
然后读取您找到的任何有趣文件的内容。

数据库查询

您可以使用 db_execute_query 查找数据库中所有在上个月加入并具有“admin”角色的用户吗？

向量搜索

请使用 vector_search 查找与“身份验证流程”相关的文档，
并总结要点。

组合工具

首先，使用 brave_web_search 查找 React 错误边界的最新最佳实践。
然后，使用 fs_read_file 检查我们在 ErrorBoundary.jsx 中的当前实现，
并根据您找到的内容提出改进建议。

🧩 如何添加您自己的工具

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

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

export function getToolDefinitions() {
  return {
    my_custom_tool: {
      name: 'my_custom_tool',
      description: '该工具的功能描述。',
      inputSchema: {
        type: 'object',
        properties: {
          param1: {
            type: 'string',
            description: '参数 1 的描述'
          }
          // 根据需要添加更多参数
        },
        required: ['param1']
      }
    }
  };
}

// 工具实现
export async function myCustomTool(param1) {
  // 您的自定义工具逻辑在此处
  return { result: 'Success!' };
}

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

🔄 本地开发

安装依赖项：
```
npm install
```
在开发模式下运行：
```
npm run dev
```
对于 stdio 模式测试：
```
npm run stdio
```

🧪 运行测试

# 运行所有测试
npm test

# 运行特定的测试套件
npm test -- --grep "API Keys"

🔧 故障排除

Claude Desktop 集成问题

启动 Claude Desktop 时出现“Unexpected token”错误：
- 确保您的包装器脚本具有正确的权限：chmod +x nexushub-mcp.sh
- 验证所有脚本是否正确过滤了非 JSON 输出
- 检查 /tmp/nexushub-debug-*.log 中的日志文件以获取详细信息
MCP 服务器未加载或工具未出现：
- 确保 Docker 容器正在运行：docker ps | grep mcp
- 检查容器日志：docker logs mcp_brave_search
- 验证 Claude Desktop 配置是否具有正确的路径/命令
- 在进行更改后尝试重新启动 Claude Desktop
Docker 容器问题：
- 如果 Docker 日志太大，请清除它们：docker system prune
- 重新启动容器：docker-compose restart
- 检查端口冲突：lsof -i :8001

常见错误消息

错误	解决方案
"Method not found"	MCP 服务器不支持此方法。检查您是否使用了正确的工具名称。
"Socket hang up"	连接问题。检查 MCP 服务器是否正在运行。
"ENOENT"	找不到文件或目录。检查配置中的路径。
"Permission denied"	文件权限问题。检查脚本权限。
"Unexpected token"	JSON 解析错误。检查 MCP 服务器的 stdout 输出。

📚 文档

工具开发指南

快速入门指南 - 在 5 分钟内启动并运行
工具开发指南 - 创建工具的综合指南
AI 工具创建提示 - 用于 AI 辅助工具创建的优化提示

集成指南

Claude Desktop 集成 - 将 NexusHub 连接到 Claude Desktop
Claude CLI 集成 - 将 NexusHub 与 Claude CLI 一起使用

MCP 资源

有关完整文档，请访问 NexusHub Wiki。

🤝 贡献

贡献是使开源社区成为一个学习、激励和创造的绝佳场所的原因。任何您做出的贡献都非常感谢。

Fork 该项目
创建您的功能分支 (git checkout -b feature/AmazingFeature)
提交您的更改 (git commit -m 'Add some AmazingFeature')
推送到该分支 (git push origin feature/AmazingFeature)
打开一个 Pull Request

📝 许可证

在 MIT 许可证下分发。有关更多信息，请参见 LICENSE。

👨‍💻 作者

Jason Brashear

🙏 鸣谢

Claude AI - 感谢其出色的 AI 功能
模型上下文协议 - 感谢协议规范
Protocol Design System - 感谢其现代 UI 设计语言
Tailwind CSS - 感谢其实用至上的 CSS 框架

<div align="center"> <sub>由 <a href="https://github.com/webdevtodayjason">Jason Brashear</a> 用 ❤️ 构建</sub> </div>

🚀 NexusHub

README

🚀 NexusHub

用于 Claude AI 工具的统一 MCP 服务器

✨ 功能

🏛️ 架构

🛠️ 可用工具

🚀 快速开始

前提条件

安装

Claude Desktop 的配置

1. HTTP 模式

2. STDIO 模式（推荐）

Docker 容器

💡 使用示例

文件操作

数据库查询

向量搜索

组合工具

🧩 如何添加您自己的工具

🔄 本地开发

🧪 运行测试

🔧 故障排除

Claude Desktop 集成问题

常见错误消息

📚 文档

工具开发指南

集成指南

MCP 资源

🤝 贡献

📝 许可证

👨‍💻 作者

🙏 鸣谢

推荐服务器