🚀 클로드 MCP 서버 생태계

🚨 중요: 문제를 일으키는 두 가지 문제

1. 글로벌 구성 필요

• MCP 구성은 반드시 글로벌( ~/.claude/claude_code_config.json )이어야 하며 로컬/프로젝트별 구성이어서는 안 됩니다.

• 디렉토리를 변경하면 로컬 구성이 손실됩니다.

2. STDIO 전송이 필요합니다

• 모든 MCP 서버는 HTTP/포트가 아닌 STDIO 통신을 사용해야 합니다.

• Claude Code는 STDIO 전송만 지원합니다.

MCP 문제에 대한 빠른 해결 방법:

지엑스피1

상태 : ✅ 최적화된 시스템 아키텍처 구현됨(2025-05-26)
서버 : 13개 구성(통합을 통해 17에서 13으로 최적화)
도구 : 통합 데이터 분석 및 향상된 메모리 최적화를 포함하여 150개 이상 사용 가능
메모리 : 서버 통합을 통해 메모리 오버헤드 58% 감소

Related MCP server: MCP Claude Code

⚡ 즉시 시작(60초)

1. 시스템 상태 확인:

bash verify-system-status.sh

2. MCP 생태계 시작:

옵션 A - PM2(생산에 권장):

./start-mcp-pm2.sh

옵션 B - CLI(레거시):

./claude-mcp-setup start

예상 : "11개 서버 모두 준비 완료, 실패 0개"

3. Claude Code에서 테스트:

/mcp

예상 : 11개의 연결된 서버가 나열됨(향상된 메모리 포함)

📚 문서

🚀 여기서 시작하세요

• ⚡ 즉시 시작 : START_HERE_IMMEDIATE.md - 지금 어디에 있는지, 다음에 무엇을 해야 하는지

• 💻 환경 상태 : DEVELOPMENT_ENVIRONMENT_STATUS.md - 현재 시스템 상태, 프로세스 상태, 검증

• ⌨️ 명령 참조 : COMMAND_REFERENCE_IMMEDIATE.md - 모든 작업에 대한 복사-붙여넣기 가능한 명령

📖 완전한 문서

• ⚡ 최신 세션 : SESSION_2025-05-26_SYSTEM_OPTIMIZATION.md - 서버 통합, 메모리 최적화 및 성능 개선

• 📊 최적화 요약 : OPTIMIZATION_SUMMARY_2025-05-26.md - 최적화 결과 요약

• 📖 현재 상태 : CURRENT_WORKING_STATE.md - 세션 2025-05-26 최적화로 업데이트됨

• 🧠 이전 세션 : SESSION_2025-05-25_ENHANCED_MEMORY_IMPLEMENTATION.md - 향상된 메모리 시스템 + MCP 수정

• 📖 전체 가이드 : README_AUTHORITATIVE_2025-05-24.md

• 📁 역사적 문서 : docs/archive/ (참고용)

🎯 이 프로젝트는 무엇입니까?

Claude AI에 150개 이상의 전문 도구를 제공하는 프로덕션 준비 MCP 서버 생태계 :

• 📊 통합 데이터 분석 (40개 이상의 도구): 파이프라인, 웨어하우징, 거버넌스, ML 배포, 실시간 분석을 결합한 통합 서버

• 🧠 향상된 메모리 (3가지 도구): 컨텍스트 압축, 계층적 메모리, 의미적 청킹을 포함한 6가지 최적화 기술

• 🔐 보안 (6개 도구): 취약점 스캐닝, 규정 준수 확인

• 🎨 디자인 (8개 도구): UI 분석, 접근성, 디자인 시스템

• 💾 메모리 관리 (5가지 도구): 영구 저장소, 컨텍스트 관리

• ⚡ 최적화 (5가지 도구): 성능 프로파일링, 병목 현상 분석

• 🏗️ 인프라 (도구 85개 이상): 데이터베이스, Docker, 구성 관리

주요 최적화(2025-05-26) : 5개의 별도 데이터 분석 서버를 1개의 통합 서버로 통합하여 모든 기능을 유지하면서 메모리 사용량을 약 350MB 줄였습니다.

인프라 : PostgreSQL + Redis + Qdrant + Docker 오케스트레이션

⚠️ 중요

문제가 보이면 :

1. 진단을 위해 bash verify-system-status.sh 실행하세요.

2. 문제 해결을 위해 README_AUTHORITATIVE_2025-05-24.md 확인하세요.

3. 다른 마크다운 파일은 무시하세요(이 파일에는 오래된 정보가 포함되어 있습니다)

최종 확인일 : 2025-05-24
근본 원인 수정됨 : claude-mcp-wrapper.sh 환경 변수 구성
결과 : 149개 도구를 사용하여 작동하는 10개 서버 모두 사용 가능