GitHub 매퍼 MCP 서버

GitHub Mapper는 GitHub 저장소를 매핑하고 분석하는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 사용자가 GitHub 개인 액세스 토큰을 설정하고 특정 저장소의 구조 및 요약 통계를 포함한 자세한 정보를 검색할 수 있도록 합니다.

특징

• 인증을 위해 GitHub 개인 액세스 토큰을 설정하세요

• GitHub 저장소 구조를 매핑하고 분석합니다.

• 저장소 요약 정보(별점, 포크, 언어 등)를 검색합니다.

• 자세한 저장소 파일 구조 제공

Related MCP server: GitHub MCP Server

필수 조건

• Node.js(v18.0.0 이상 권장)

• npm(Node.js와 함께 제공)

• 적절한 권한이 있는 GitHub 개인 액세스 토큰

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 GitHub Mapper를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 저장소를 복제합니다.

   git clone https://github.com/your-username/github-mapper-mcp-server.git
   cd github-mapper-mcp-server

2. 종속성 설치:

   npm install

3. 프로젝트를 빌드하세요:

   npm run build

용법

1. 서버를 시작합니다:

   npm start

2. 서버는 stdio에서 실행되므로 MCP 클라이언트와 통신할 수 있습니다.

사용 가능한 도구

1. set-github-token

인증을 위한 GitHub 개인 액세스 토큰을 설정합니다.

• 여기에서 개인 액세스 토큰을 생성하세요. 토큰(클래식)을 선택하세요. 범위: repo

예를 들어, IDE 또는 Claude Desktop에서:

Please set-github-token to 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

2. map-github-repo

GitHub 저장소 구조를 매핑하고 요약 정보를 제공합니다.

예:

Please map-github-repo https://github.com/dazeb/MCP-Github-Mapper

Cline 또는 Roo-Cline MCP 클라이언트에 수동 설치:

{
  "mcpServers": {
    "github-mapper": {
      "command": "node",
      "args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"]
    }
  }
}

출력 예

Repository Analysis Summary:

Name: Hello-World
Description: My first repository on GitHub!
Stars: 1234
Forks: 567
Primary Language: JavaScript
Created: 2023-01-01
Last Updated: 2023-06-15

Repository Structure:

{
  "src": {
    "components": {
      "Header.js": null,
      "Footer.js": null
    },
    "pages": {
      "index.js": null,
      "about.js": null
    },
    "styles": {
      "global.css": null
    }
  },
  "public": {
    "images": {
      "logo.png": null
    },
    "favicon.ico": null
  },
  "package.json": null,
  "README.md": null
}

이미지

실행 평가

evals 패키지는 index.ts 파일을 실행하는 mcp 클라이언트를 로드하므로 테스트 사이에 다시 빌드할 필요가 없습니다. npx 명령 앞에 접두사를 붙여 환경 변수를 로드할 수 있습니다. 전체 문서는 여기에서 확인할 수 있습니다.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

오류 처리

• GitHub 토큰이 설정되지 않은 경우 먼저 set-github-token 도구를 사용하라는 오류 메시지가 표시됩니다.

• 잘못된 GitHub URL이나 저장소 경로가 있으면 해당 오류 메시지가 표시됩니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.