local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Utilizes environment variables for configuration, particularly for storing the Anthropic API key
Uses Node.js as the runtime environment for the MCP server, requiring version 18 or higher
Implements the server using TypeScript for type safety and modularity in the codebase

MCP 전문가 서버

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

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

필수 조건

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

설치

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

지엑스피1

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

ANTHROPIC_API_KEY=your_api_key_here

설정

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

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

npm run build
npm run setup

이렇게 하면:

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

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

용법

독립형 서버

서버를 시작합니다:

npm start

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

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 데스크톱 통합

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

{
  "mcpServers": {
    "expert": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

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

디렉토리 구조

.
├── docs/                  # Your API documentation files
├── prompts/              # System prompts and metadata
│   ├── system-prompt.txt    # Main system prompt
│   ├── tool-metadata.txt    # Tool description context
│   ├── query-metadata.txt   # Query generation context
│   └── service-description.txt  # Generated service description
├── src/                  # Source code
│   ├── index.ts            # Entry point
│   ├── server.ts           # MCP server implementation
│   └── services/           # Core services
│       └── expertService.ts  # Claude integration
└── package.json

개발

프로젝트를 빌드하세요:

npm run build

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

문제 해결

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

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

npm run setup

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

환경 변수

ANTHROPIC_API_KEY : Anthropic API 키(필수)

특허

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude AI를 활용하여 지능형 쿼리를 생성하고 API 문서 분석을 기반으로 문서 지원을 제공하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

MCP Expert Server