MCP Expert Server

MCP 전문가 서버

Claude AI를 사용하여 지능형 쿼리 생성 및 문서화 지원을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 API 문서를 분석하고 두 가지 주요 도구를 제공합니다.

• create-query : 자연어 요청을 기반으로 쿼리를 생성합니다.
• 문서화 : 질문에 따라 관련 문서 정보를 제공합니다.

필수 조건

• 노드.js >= 18
• Claude를 위한 Anthropic API 키

설치

1. 저장소를 복제합니다
2. 종속성 설치:

지엑스피1

3. Anthropic API 키로 .env 파일을 만듭니다.

설정

서버를 실행하기 전에 다음이 필요합니다.

1. 프로젝트를 빌드하고 설치 스크립트를 실행합니다.

이렇게 하면:

• 필요한 디렉토리( docs/ 및 prompts/ )를 생성합니다.
• 기본 프롬프트 파일 만들기
• 초기 서비스 설명 생성

2. API 문서 파일을 docs/ 디렉토리에 추가합니다( .txt , .md 및 .json 파일 지원)
3. 선택적으로 prompts/ 디렉토리의 프롬프트를 사용자 정의합니다.
   • system-prompt.txt : Claude의 기본 시스템 프롬프트
   • tool-metadata.txt : 도구 설명에 대한 추가 컨텍스트
   • query-metadata.txt : 쿼리 생성을 위한 추가 컨텍스트
   • service-description.txt : 자동 생성된 서비스 설명

용법

독립형 서버

서버를 시작합니다:

서버는 모델 컨텍스트 프로토콜을 통해 두 가지 도구를 제공합니다.

• create-query : 자연어 요청에 기반한 쿼리 생성
  { "name": "create-query", "arguments": { "request": "Find all users who signed up in the last week" } }
• 문서 : 문서에서 정보를 얻으세요
  { "name": "documentation", "arguments": { "request": "How do I authenticate API requests?" } }

Claude 데스크톱 통합

1. Claude Desktop 구성 파일에 다음 구성을 추가하세요.

2. /ABSOLUTE/PATH/TO/expert-server 서버 설치의 실제 절대 경로로 바꾸세요.
3. Claude Desktop을 다시 시작합니다.

디렉토리 구조

개발

• 프로젝트를 빌드하세요:

• 서버는 TypeScript를 사용하고 모듈형 아키텍처를 따릅니다.
• 모든 Claude 상호 작용은 ExpertService 클래스에서 처리됩니다.
• 디버그 로그는 [DEBUG] 접두사를 사용하여 stderr에 기록됩니다.

문제 해결

연결 문제가 발생하는 경우:

1. 설치 스크립트를 실행했는지 확인하세요.

2. prompts/ 디렉토리에 필요한 모든 파일이 있는지 확인하세요.
3. ANTHROPIC_API_KEY 가 올바르게 설정되었는지 확인하세요.
4. Claude Desktop 구성에서 절대 경로를 사용하세요
5. 디버그 로그(stderr에 기록됨)를 확인하세요.

환경 변수

• ANTHROPIC_API_KEY : Anthropic API 키(필수)

특허

MIT