Nexus-MCP

面向 AI 助手的全面模型上下文协议（MCP）工具包

将任何 AI 助手转变为能够执行现实任务的自主智能体。

文档 • 入门指南 • 路线图 • 架构

🎯 概述

Nexus-MCP 是一个使用 TypeScript/Node.js 构建的强大 模型上下文协议 (MCP) 服务器，它为 AI 模型提供了通用的工具，用于：

• 📁 文件系统操作 - 读取、写入、搜索和监控文件

• 🌐 HTTP/Web 请求 - 获取数据、抓取网站、调用 API

• 🔄 Git 工作流 - 克隆、提交、分支和管理仓库

• 🗄️ 数据库查询 - 查询 SQL 和 NoSQL 数据库

• 💻 系统命令 - 执行 Shell 命令并管理进程

• 🤖 AI 集成 - 与 LLM 聊天、创建嵌入、处理文本

• 🔧 实用工具 - JSON/YAML 解析、压缩、加密等

🚀 快速开始

安装

npm install -g @nexus-mcp/server

配置

# Copy example environment file
cp .env.example .env

# Edit with your settings
nano .env

运行

nexus-mcp

与 Claude Code 集成

添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/index.js"]
    }
  }
}

📦 功能特性

文件系统工具

• nexus_read_file - 读取支持编码的文件

• nexus_write_file - 写入/创建文件

• nexus_list_directory - 列出目录内容

• nexus_search_files - 按模式搜索文件

• nexus_search_content - 搜索文件内容

• nexus_watch_directory - 监控目录变更

HTTP 工具

• nexus_http_get - HTTP GET 请求

• nexus_http_post - HTTP POST 请求

• nexus_fetch_url - 获取并解析网页内容

• nexus_parse_html - 使用 Cheerio 解析 HTML

• nexus_call_api - 通用 API 调用

Git 工具

• nexus_git_clone - 克隆仓库

• nexus_git_commit - 创建提交

• nexus_git_push - 推送到远程

• nexus_git_pr_create - 创建拉取请求 (PR)

• 与 GitHub、GitLab、Bitbucket 集成

数据库工具

• nexus_db_query - 执行 SQL 查询

• nexus_db_list_tables - 列出数据库表

• nexus_db_describe_table - 描述表结构

• 支持 PostgreSQL、MySQL、SQLite、SQL Server、MongoDB

系统工具

• nexus_exec_command - 执行 Shell 命令

• nexus_system_info - 获取系统信息

• nexus_process_list - 列出运行中的进程

• nexus_service_start/stop - 管理服务

AI 工具

• nexus_llm_chat - 与 LLM 聊天 (Anthropic, OpenAI)

• nexus_embedding_create - 创建文本嵌入

• nexus_text_summarize - 文本摘要

• nexus_code_generate - 生成代码

实用工具

• nexus_json_parse/stringify - JSON 操作

• nexus_yaml_parse/stringify - YAML 操作

• nexus_zip_create/extract - ZIP 压缩/解压

• nexus_encrypt/decrypt - 加密/解密

🏗️ 架构

┌─────────────────────────────────────────┐
│         Claude / LLM Client              │
└──────────────┬──────────────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────────────┐
│           Nexus-MCP Server               │
│  ┌───────────────────────────────────┐  │
│  │      MCP Server Core             │  │
│  └───────────────────────────────────┘  │
│         ┌───────┴───────┐                │
│         │               │                │
│    ┌────▼────┐    ┌────▼────┐           │
│    │ Filesys │    │   HTTP  │           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │   Git   │    │ Database│           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │  System │    │    AI   │           │
│    └─────────┘    └─────────┘           │
└─────────────────────────────────────────┘

有关详细架构，请参阅 docs/architecture.md

🏛️ 生产级质量

Nexus-MCP 的构建秉承卓越架构理念，专为生产环境使用和社区采用而设计。我们遵循严格的原则：

• ✅ 类型安全：TypeScript 严格模式 + Zod 验证

• ✅ 错误处理：结构化、可操作的错误消息

• ✅ 性能：异步操作、缓存、流式处理

• ✅ 安全性：输入验证、清理、审计日志

• ✅ 可观测性：结构化日志、指标、追踪

• ✅ 可测试性：80%+ 覆盖率，依赖注入

• ✅ 文档：JSDoc、示例、综合指南

• ✅ 开发者体验：清晰的错误提示、IDE 支持、快速反馈

请参阅 架构原则 了解完整详情。

📚 文档

• 入门指南 - 快速开始和基本用法

• 架构文档 - 系统架构和设计

• 架构原则 - 设计原则和最佳实践

• API 参考 - 完整的 API 文档

• 工具参考 - 详细的工具文档

• 路线图 - 开发路线图和进度

🛠️ 开发

# Clone repository
git clone https://github.com/your-org/Nexus-MCP.git
cd Nexus-MCP

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Lint code
npm run lint

📊 项目状态

• 当前版本：1.0.0-alpha

• 开发状态：规划与设计

• 核心进度：0%

• 目标工具：50+

• 测试覆盖率目标：80%+

请参阅 ROADMAP.md 了解详细进度。

🤝 贡献

欢迎贡献！在提交 PR 之前，请阅读我们的贡献指南。

1. Fork 本仓库

2. 创建您的功能分支 (git checkout -b feature/amazing-feature)

3. 提交您的更改 (git commit -m 'Add amazing feature')

4. 推送到分支 (git push origin feature/amazing-feature)

5. 开启一个 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 支持

• 📖 文档

• 🐛 问题追踪

• 💬 Discord 社区

• ✉️ 电子邮件: support@nexus-mcp.dev

由 Nexus 团队用心构建 ❤️