Nexus Hub (Deptz)

MCP搜索检索

提供方 deptz

搜索检索 stdio · 本地进程 API Key 社区 / 第三方
查看接入方式

Nexus Hub是一个基于Python的多租户AI对话协调器,支持跨多个渠道(WhatsApp、Web、Slack、Email、Telegram)进行对话,并集成了OpenAI、Gemini、内部RAG和MCP工具。

一句话选型结论

按资料字段整理

Nexus Hub (Deptz) 属于搜索检索类 MCP 服务器,stdio · 本地进程,API Key,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

多租户Python本地部署AI对话多通道支持LLM集成RAG

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
pip install --upgrade pip

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Nexus Hub (Deptz)当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方deptz上游标注的维护方 deptz
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.0 KB
来自项目仓库与上游目录的原文,未做删改

Nexus Hub

基于Python的编排器,用于跨多个渠道(WhatsApp、Web、Slack、电子邮件、Telegram)进行多租户AI对话,支持OpenAI、Gemini、内部RAG和MCP工具。

前端管理仪表板

Nexus Hub管理员 -用于管理Nexus Hub的Vue.js管理仪表板可在 https://github.com/deptz/nexus-hub-fe.管理仪表板提供了一个用户友好的界面,用于管理租户、API密钥、消息等。

快速开始

项目新手? 看 docs/guides/KICKSTART_GUIDE.md 获取5分钟内入门的分步指南!

特性

  • 多渠道支持 -WhatsApp、网络、Slack、电子邮件、电报
  • 多LLM支持 -OpenAI、Gemini,具有统一接口
  • 知识库 -内部RAG(pgvector)、OpenAI文件搜索、Gemini文件搜索
  • MCP集成 -模型上下文协议服务器支持
  • 租户隔离 -严格的行级安全(RLS)执行
  • 分层提示 -核心护栏、全局系统提示、租户自定义提示
  • 工具抽象 -统一工具执行引擎
  • 事件日志记录 -全面的可观察性和报告
  • 代理规划 -主动规划和任务管理

先决条件

  • Python 3.11+(建议用于最新的软件包版本)
  • PostgreSQL 15+ pgvector 扩展
  • (可选)用于OpenAI集成的OpenAI API密钥
  • (可选)Gemini集成的Gemini API密钥
  • (可选)Redis用于速率限制和消息队列

安装

1.克隆和设置```bash

Create virtual environment

python3.11 -m venv venv
source venv/bin/activate # On macOS/Linux

or

venv\Scripts\activate # On Windows

Install dependencies

pip install --upgrade pip
pip install -r requirements.txt


### 2.数据库设置```bash
# Create database
createdb nexus_hub

# Enable pgvector extension
psql -d nexus_hub -c "CREATE EXTENSION IF NOT EXISTS vector;"

# Run migrations
psql -d nexus_hub -f migrations/001_initial_schema.sql
psql -d nexus_hub -f migrations/002_enable_rls.sql

3.环境配置```bash

Copy example environment file

cp .env.example .env

Edit .env with your configuration values

Minimum required: DATABASE_URL


### 4.启动服务器```bash
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

API将于 http://localhost:8000

用法

健康检查```bash

curl http://localhost:8000/health


### 发送信息```bash
curl -X POST http://localhost:8000/messages/inbound \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"tenant_id": "your-tenant-uuid",
"channel": "web",
"direction": "inbound",
"from": {"type": "user", "external_id": "user-123"},
"to": {"type": "bot", "external_id": "bot-1"},
"content": {"type": "text", "text": "Hello, how can you help me?"},
"metadata": {},
"timestamp": "2025-01-16T10:00:00Z"
}'

文档

  • 入门指南 -完整的设置和测试指南
  • 系统架构 -系统设计和架构
  • 代理消息流 -代理规划是如何运作的
  • 及时管理 -快速架构和验证
  • API关键实现 -安全的API密钥管理
  • MCP服务器安全 -MCP服务器的安全要求
  • 电报设置 -电报适配器配置
  • 贡献 -贡献指南
  • 完整文档索引 -完整的文档索引

API文档

服务器运行后:

  • Swagger用户界面: http://localhost:8000/docs
  • ReDoc: http://localhost:8000/redoc

项目结构```

nexus-hub/
├── app/
│ ├── models/ # Domain models
│ ├── services/ # Business logic
│ ├── adapters/ # Vendor adapters (OpenAI, Gemini, RAG, MCP)
│ ├── api/ # FastAPI routes
│ ├── infra/ # Infrastructure (database, config, auth)
│ └── main.py # FastAPI application
├── migrations/ # SQL migration files
├── docs/ # Documentation
│ ├── guides/ # User guides
│ ├── technical/ # Technical documentation
│ └── development/ # Development docs
├── tests/ # Test suite
└── scripts/ # Utility scripts


## 主要特点

### 租户隔离

- 所有数据库查询的作用域都是 `tenant_id`
- RLS策略在数据库级别强制隔离
- `TenantContext` 对所有操作都是强制性的

### 快速架构

分层提示堆栈:

1. **核心护栏** (不可变,平台控制)
1. **全局系统提示** (默认行为)
1. **租户自定义提示** (已验证,租户特定)
1. **对话历史** (令牌截断)
1. **当前用户消息**

### 工具执行

支持统一工具抽象:

- `internal_rag` -内部RAG(pgvector)语义搜索
- `openai_file` -通过矢量存储进行OpenAI文件搜索
- `gemini_file` -通过文件搜索商店进行Gemini文件搜索
- `mcp` -MCP服务器工具

## 测试```bash
# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=app --cov-report=html

# See tests/README.md for detailed test documentation

贡献

我们欢迎捐款!请看 贡献.md 作为指导方针。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Nexus Hub (Deptz) 怎么安装?

在客户端按下面的安装命令接入:pip install --upgrade pip。装完在客户端配置里引用同一个包或端点。

Nexus Hub (Deptz) 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Nexus Hub (Deptz) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Nexus Hub (Deptz) 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Nexus Hub (Deptz) 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 多租户、Python、RAG。具体工具清单以官方文档为准。

Nexus Hub (Deptz) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Nexus Hub (Deptz) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。