Gitee

Máy chủ Gitee MCP

Gitee MCP Server là một triển khai máy chủ Giao thức Ngữ cảnh Mô hình (MCP) dành cho Gitee. Nó cung cấp một bộ công cụ để tương tác với API của Gitee, cho phép các trợ lý AI quản lý kho lưu trữ, vấn đề, yêu cầu kéo và nhiều hơn nữa.

Tính năng

• Tương tác với kho lưu trữ, vấn đề, yêu cầu kéo và thông báo của Gitee
• URL cơ sở API có thể cấu hình để hỗ trợ các phiên bản Gitee khác nhau
• Cờ dòng lệnh để dễ dàng cấu hình
• Hỗ trợ cả thao tác cá nhân, tổ chức và doanh nghiệp
• Bật/tắt bộ công cụ động

Kịch bản thực tế: Lấy Vấn đề từ kho lưu trữ, triển khai và tạo Yêu cầu Kéo

1. Lấy Vấn đề của kho lưu trữ
2. Triển khai mã & tạo Yêu cầu Kéo dựa trên chi tiết Vấn đề
3. Bình luận & Đóng Vấn đề

Cài đặt (Có thể bỏ qua bước này trực tiếp khi khởi động npx)

Điều kiện tiên quyết

• Go 1.23.0 trở lên
• Tài khoản Gitee với mã thông báo truy cập, Đi tới lấy

Xây dựng từ Mã nguồn

1. Sao chép kho lưu trữ:

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

2. Xây dựng dự án:

   make build
   

   Di chuyển ./bin/mcp-gitee vào biến môi trường PATH

Sử dụng go install

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

Cách sử dụng

Kiểm tra phiên bản mcp-gitee:

mcp-gitee --version

Cấu hình Máy chủ MCP

Ví dụ cấu hình: Nhấp để xem thêm cấu hình ứng dụng

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

Máy chủ MCP Từ xa

Kết nối đến máy chủ mcp-gitee từ xa chính thức (không cần cài đặt):

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

Codex sử dụng ~/.codex/config.toml:

[mcp_servers.gitee]
url = "https://api.gitee.com/mcp"
bearer_token_env_var = "GITEE_ACCESS_TOKEN"

opencode sử dụng ~/.config/opencode/opencode.json:

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

Tùy chọn Dòng lệnh

• --token: Mã thông báo truy cập Gitee
• --api-base: URL cơ sở API Gitee (mặc định: https://gitee.com/api/v5)
• --version: Hiển thị thông tin phiên bản
• --transport: Loại truyền tải (stdio、sse hoặc http, mặc định: stdio)
• --address: Máy chủ và cổng để khởi động máy chủ (mặc định: localhost:8000)
• --enabled-toolsets: Danh sách công cụ được bật, phân tách bằng dấu phẩy (nếu được chỉ định, chỉ những công cụ này sẽ được bật)
• --disabled-toolsets: Danh sách công cụ bị vô hiệu hóa, phân tách bằng dấu phẩy

Biến Môi trường

Bạn cũng có thể cấu hình máy chủ bằng các biến môi trường:

• GITEE_ACCESS_TOKEN: Mã thông báo truy cập Gitee
• GITEE_API_BASE: URL cơ sở API Gitee
• ENABLED_TOOLSETS: Danh sách công cụ được bật, phân tách bằng dấu phẩy
• DISABLED_TOOLSETS: Danh sách công cụ bị vô hiệu hóa, phân tách bằng dấu phẩy

Quản lý Bộ công cụ

Quản lý bộ công cụ hỗ trợ hai chế độ:

1. Bật các công cụ được chỉ định (chế độ danh sách trắng):

   • Sử dụng tham số --enabled-toolsets hoặc biến môi trường ENABLED_TOOLSETS
   • Sau khi chỉ định, chỉ các công cụ được liệt kê sẽ được bật, các công cụ khác sẽ bị vô hiệu hóa
   • Ví dụ: --enabled-toolsets="list_user_repos,get_file_content"

2. Vô hiệu hóa các công cụ được chỉ định (chế độ danh sách đen):

   • Sử dụng tham số --disabled-toolsets hoặc biến môi trường DISABLED_TOOLSETS
   • Sau khi chỉ định, các công cụ được liệt kê sẽ bị vô hiệu hóa, các công cụ khác sẽ được bật
   • Ví dụ: --disabled-toolsets="list_user_repos,get_file_content"

Lưu ý:

• Nếu cả enabled-toolsets và disabled-toolsets đều được chỉ định, enabled-toolsets được ưu tiên
• Tên công cụ phân biệt chữ hoa chữ thường

Lọc Công cụ Theo Yêu cầu (Tiêu đề HTTP)

Khi sử dụng máy chủ MCP từ xa (truyền tải HTTP/SSE), bạn có thể lọc động các công cụ khả dụng trên cơ sở từng yêu cầu thông qua tiêu đề HTTP. Điều này hữu ích cho các máy khách cần kiểm soát chi tiết việc hiển thị công cụ mà không cần khởi động lại máy chủ.

1. Bật các công cụ được chỉ định qua tiêu đề (danh sách trắng):

   • Sử dụng tiêu đề X-MCP-Enabled-Tools
   • Chỉ các công cụ được liệt kê sẽ được bật cho yêu cầu đó
   • Ví dụ: X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. Vô hiệu hóa các công cụ được chỉ định qua tiêu đề (danh sách đen):

   • Sử dụng tiêu đề X-MCP-Disabled-Tools
   • Các công cụ được liệt kê sẽ bị vô hiệu hóa cho yêu cầu đó
   • Ví dụ: X-MCP-Disabled-Tools: create_repo,delete_repo

Quy tắc ưu tiên:

• Nếu cả X-MCP-Enabled-Tools và X-MCP-Disabled-Tools đều có trong cùng một yêu cầu, danh sách trắng (X-MCP-Enabled-Tools) được ưu tiên
• Tên công cụ phân biệt chữ hoa chữ thường

Ví dụ cấu hình cho Cursor/Claude:

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT. Xem tệp LICENSE để biết thêm chi tiết.

Công cụ Khả dụng

Máy chủ cung cấp nhiều công cụ khác nhau để tương tác với Gitee:

Công cụ	Danh mục	Mô tả
list_user_repos	Kho lưu trữ	Liệt kê các kho lưu trữ được ủy quyền của người dùng
get_file_content	Kho lưu trữ	Lấy nội dung của một tệp trong kho lưu trữ
create_repo	Kho lưu trữ	Tạo một kho lưu trữ (người dùng, tổ chức hoặc doanh nghiệp)
fork_repository	Kho lưu trữ	Sao chép một kho lưu trữ
create_release	Kho lưu trữ	Tạo một bản phát hành cho kho lưu trữ
list_releases	Kho lưu trữ	Liệt kê các bản phát hành của kho lưu trữ
search_open_source_repositories	Kho lưu trữ	Tìm kiếm các kho lưu trữ mã nguồn mở trên Gitee
search_files_by_content	Kho lưu trữ	Tìm kiếm tệp theo nội dung trong một kho lưu trữ
compare_branches_tags	Kho lưu trữ	So sánh hai nhánh, thẻ hoặc cam kết trong một kho lưu trữ
list_repo_pulls	Yêu cầu Kéo	Liệt kê các yêu cầu kéo trong một kho lưu trữ
merge_pull	Yêu cầu Kéo	Hợp nhất một yêu cầu kéo
create_pull	Yêu cầu Kéo	Tạo một yêu cầu kéo
update_pull	Yêu cầu Kéo	Cập nhật một yêu cầu kéo
get_pull_detail	Yêu cầu Kéo	Lấy chi tiết của một yêu cầu kéo
get_diff_files	Yêu cầu Kéo	Lấy các tệp khác biệt của một yêu cầu kéo
manage_pull_review	Yêu cầu Kéo	Quản lý đánh giá yêu cầu kéo (phê duyệt hoặc hủy bỏ)
create_comment	Bình luận	Tạo bình luận cho một vấn đề hoặc yêu cầu kéo
list_comments	Bình luận	Liệt kê tất cả bình luận cho một vấn đề hoặc yêu cầu kéo
create_issue	Vấn đề	Tạo một vấn đề
update_issue	Vấn đề	Cập nhật một vấn đề
get_repo_issue_detail	Vấn đề	Lấy chi tiết của một vấn đề trong kho lưu trữ
list_repo_issues	Vấn đề	Liệt kê các vấn đề của kho lưu trữ
get_user_info	Người dùng	Lấy thông tin người dùng đã xác thực hiện tại
search_users	Người dùng	Tìm kiếm người dùng
list_user_notifications	Thông báo	Liệt kê thông báo của người dùng

Đóng góp

Chúng tôi hoan nghênh sự đóng góp từ cộng đồng mã nguồn mở! Nếu bạn muốn đóng góp cho dự án này, vui lòng tuân theo các hướng dẫn sau:

1. Sao chép kho lưu trữ.
2. Tạo một nhánh mới cho tính năng hoặc sửa lỗi của bạn.
3. Thực hiện các thay đổi và đảm bảo mã được ghi chép đầy đủ.
4. Gửi một yêu cầu kéo với mô tả rõ ràng về các thay đổi của bạn.

Để biết thêm thông tin, vui lòng tham khảo tệp CONTRIBUTING.