Gitee MCP 서버

Gitee MCP 서버는 Gitee를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현체입니다. Gitee API와 상호작용하기 위한 일련의 도구를 제공하여 AI 어시스턴트가 저장소, 이슈, 풀 리퀘스트 등을 관리할 수 있도록 합니다.

기능

• Gitee 저장소, 이슈, 풀 리퀘스트 및 알림과 상호작용

• 다양한 Gitee 인스턴스를 지원하기 위한 구성 가능한 API 기본 URL

• 쉬운 구성을 위한 명령줄 플래그

• 개인, 조직 및 기업 작업 모두 지원

• 동적 도구 세트 활성화/비활성화

1. 저장소 이슈 가져오기

2. 이슈 세부 정보를 기반으로 코딩 구현 및 풀 리퀘스트 생성

3. 댓글 작성 및 이슈 닫기

Related MCP server: PyGithub MCP Server

설치(npx로 시작할 경우 이 단계는 건너뛸 수 있습니다)

사전 요구 사항

• Go 1.23.0 이상

• 액세스 토큰이 있는 Gitee 계정, 가져오기

소스에서 빌드

1. 저장소 복제:

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee

2. 프로젝트 빌드:

   make build

   ./bin/mcp-gitee를 PATH 환경 변수에 추가하세요.

go install 사용

go install gitee.com/oschina/mcp-gitee@latest

사용법

mcp-gitee 버전 확인:

mcp-gitee --version

MCP 호스트 구성

구성 예시: 더 많은 애플리케이션 구성 보기

• 공식 원격 mcp-gitee 서버에 연결 (설치 불필요)

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

• npx

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

• 실행 파일

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

명령줄 옵션

• --token: Gitee 액세스 토큰

• --api-base: Gitee API 기본 URL (기본값: https://gitee.com/api/v5)

• --version: 버전 정보 표시

• --transport: 전송 유형 (stdio, sse 또는 http, 기본값: stdio)

• --address: 서버를 시작할 호스트 및 포트 (기본값: localhost:8000)

• --enabled-toolsets: 활성화할 도구의 쉼표로 구분된 목록 (지정된 경우 이 도구들만 활성화됨)

• --disabled-toolsets: 비활성화할 도구의 쉼표로 구분된 목록

환경 변수

환경 변수를 사용하여 서버를 구성할 수도 있습니다:

• GITEE_ACCESS_TOKEN: Gitee 액세스 토큰

• GITEE_API_BASE: Gitee API 기본 URL

• ENABLED_TOOLSETS: 활성화할 도구의 쉼표로 구분된 목록

• DISABLED_TOOLSETS: 비활성화할 도구의 쉼표로 구분된 목록

도구 세트 관리

도구 세트 관리는 두 가지 모드를 지원합니다:

1. 지정된 도구 활성화 (화이트리스트 모드):

   • --enabled-toolsets 매개변수 또는 ENABLED_TOOLSETS 환경 변수 사용

   • 지정 후 나열된 도구만 활성화되며 나머지는 비활성화됨

   • 예: --enabled-toolsets="list_user_repos,get_file_content"

2. 지정된 도구 비활성화 (블랙리스트 모드):

   • --disabled-toolsets 매개변수 또는 DISABLED_TOOLSETS 환경 변수 사용

   • 지정 후 나열된 도구는 비활성화되며 나머지는 활성화됨

   • 예: --disabled-toolsets="list_user_repos,get_file_content"

참고:

• enabled-toolsets와 disabled-toolsets가 모두 지정된 경우 enabled-toolsets가 우선합니다.

• 도구 이름은 대소문자를 구분합니다.

라이선스

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

사용 가능한 도구

서버는 Gitee와 상호작용하기 위한 다양한 도구를 제공합니다:

기여

오픈 소스 커뮤니티의 기여를 환영합니다! 이 프로젝트에 기여하고 싶으시다면 다음 지침을 따르십시오:

1. 저장소를 포크합니다.

2. 기능 또는 버그 수정을 위한 새 브랜치를 만듭니다.

3. 변경 사항을 적용하고 코드가 잘 문서화되었는지 확인합니다.

4. 변경 사항에 대한 명확한 설명과 함께 풀 리퀘스트를 제출합니다.

자세한 내용은 CONTRIBUTING 파일을 참조하십시오.