MCP 服务器

Nexus-MCP

A comprehensive Model Context Protocol toolkit that transforms AI assistants into autonomous agents capable of executing real-world tasks across filesystems, web requests, Git workflows, databases, system commands, and AI integrations.

README

Nexus-MCP

A Comprehensive Model Context Protocol Toolkit for AI Assistants

Transform any AI assistant into an autonomous agent capable of executing real-world tasks.

Documentation • Getting Started • Roadmap • Architecture

</div>

🎯 Overview

Nexus-MCP is a powerful Model Context Protocol (MCP) server built with TypeScript/Node.js that provides AI models with universal tools for:

📁 File System Operations - Read, write, search, and monitor files
🌐 HTTP/Web Requests - Fetch data, scrape websites, call APIs
🔄 Git Workflows - Clone, commit, branch, and manage repositories
🗄️ Database Queries - Query SQL and NoSQL databases
💻 System Commands - Execute shell commands and manage processes
🤖 AI Integration - Chat with LLMs, create embeddings, process text
🔧 Utilities - JSON/YAML parsing, compression, encryption, and more

🚀 Quick Start

Installation

npm install -g @nexus-mcp/server

Configuration

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

# Edit with your settings
nano .env

Run

nexus-mcp

Integration with Claude Code

Add to your Claude Desktop config:

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

📦 Features

Filesystem Tools

nexus_read_file - Read files with encoding support
nexus_write_file - Write/create files
nexus_list_directory - List directory contents
nexus_search_files - Search files by pattern
nexus_search_content - Search content within files
nexus_watch_directory - Monitor directory changes

HTTP Tools

nexus_http_get - HTTP GET requests
nexus_http_post - HTTP POST requests
nexus_fetch_url - Fetch and parse web content
nexus_parse_html - Parse HTML with Cheerio
nexus_call_api - Generic API calls

Git Tools

nexus_git_clone - Clone repositories
nexus_git_commit - Create commits
nexus_git_push - Push to remote
nexus_git_pr_create - Create pull requests
Integration with GitHub, GitLab, Bitbucket

Database Tools

nexus_db_query - Execute SQL queries
nexus_db_list_tables - List database tables
nexus_db_describe_table - Describe table schema
Support for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB

System Tools

nexus_exec_command - Execute shell commands
nexus_system_info - Get system information
nexus_process_list - List running processes
nexus_service_start/stop - Manage services

AI Tools

nexus_llm_chat - Chat with LLMs (Anthropic, OpenAI)
nexus_embedding_create - Create text embeddings
nexus_text_summarize - Summarize text
nexus_code_generate - Generate code

Utilities Tools

nexus_json_parse/stringify - JSON manipulation
nexus_yaml_parse/stringify - YAML manipulation
nexus_zip_create/extract - ZIP compression
nexus_encrypt/decrypt - Encryption/decryption

🏗️ Architecture

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

For detailed architecture, see docs/architecture.md

🏛️ Production-Grade Quality

Nexus-MCP is built with architectural excellence in mind, designed for production use and community adoption. We follow strict principles:

✅ Type Safety: TypeScript strict mode + Zod validation
✅ Error Handling: Structured, actionable error messages
✅ Performance: Async operations, caching, streaming
✅ Security: Input validation, sanitization, audit logs
✅ Observability: Structured logging, metrics, tracing
✅ Testability: 80%+ coverage, dependency injection
✅ Documentation: JSDoc, examples, comprehensive guides
✅ Developer Experience: Clear errors, IDE support, quick feedback

See Architectural Principles for complete details.

📚 Documentation

Getting Started Guide - Quick start and basic usage
Architecture Documentation - System architecture and design
Architectural Principles - Design principles and best practices
API Reference - Complete API documentation
Tools Reference - Detailed tool documentation
Roadmap - Development roadmap and progress

🛠️ Development

# 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