Nexus-MCP

AI 어시스턴트를 위한 포괄적인 모델 컨텍스트 프로토콜 툴킷

모든 AI 어시스턴트를 실제 작업을 수행할 수 있는 자율 에이전트로 변환하세요.

문서 • 시작하기 • 로드맵 • 아키텍처

🎯 개요

Nexus-MCP는 TypeScript/Node.js로 구축된 강력한 모델 컨텍스트 프로토콜(MCP) 서버로, AI 모델에 다음과 같은 범용 도구를 제공합니다:

• 📁 파일 시스템 작업 - 파일 읽기, 쓰기, 검색 및 모니터링

• 🌐 HTTP/웹 요청 - 데이터 가져오기, 웹사이트 스크래핑, API 호출

• 🔄 Git 워크플로우 - 복제(Clone), 커밋, 브랜치 및 저장소 관리

• 🗄️ 데이터베이스 쿼리 - SQL 및 NoSQL 데이터베이스 쿼리

• 💻 시스템 명령 - 셸 명령 실행 및 프로세스 관리

• 🤖 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 - 풀 리퀘스트 생성

• GitHub, GitLab, Bitbucket 통합

데이터베이스 도구

• nexus_db_query - SQL 쿼리 실행

• nexus_db_list_tables - 데이터베이스 테이블 나열

• nexus_db_describe_table - 테이블 스키마 설명

• PostgreSQL, MySQL, SQLite, SQL Server, MongoDB 지원

시스템 도구

• nexus_exec_command - 셸 명령 실행

• 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 유효성 검사

• ✅ 오류 처리: 구조화되고 실행 가능한 오류 메시지

• ✅ 성능: 비동기 작업, 캐싱, 스트리밍

• ✅ 보안: 입력 유효성 검사, 살균(Sanitization), 감사 로그

• ✅ 관측 가능성: 구조화된 로깅, 메트릭, 추적

• ✅ 테스트 가능성: 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. 풀 리퀘스트를 여세요

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

🙏 감사의 말

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 지원

• 📖 문서

• 🐛 이슈 트래커

• 💬 Discord 커뮤니티

• ✉️ 이메일: support@nexus-mcp.dev

Nexus 팀이 ❤️를 담아 제작함