Gitee

आधिकारिक

Gitee API एकीकरण, रिपॉजिटरी, इश्यू और पुल रिक्वेस्ट प्रबंधन, और अधिक।

Gitee MCP के साथ आप क्या कर सकते हैं?

  • रिपॉजिटरी समस्याएँ प्रबंधित करें — अपने सहायक से किसी रिपॉजिटरी में समस्याओं को सूचीबद्ध, बनाने या अपडेट करने के लिए कहें, list_repo_issues, create_issue, और update_issue का उपयोग करके।
  • पुल अनुरोध संभालें — अपने सहायक से पुल अनुरोधों को सूचीबद्ध, बनाने, मर्ज करने या समीक्षा करने के लिए कहें, जैसे टूल list_repo_pulls, create_pull, merge_pull, और manage_pull_review के साथ।
  • रिपॉजिटरी सामग्री एक्सप्लोर करें — फ़ाइल सामग्री प्राप्त करें, ब्रांच या टैग की तुलना करें, और सामग्री द्वारा फ़ाइलें खोजें, get_file_content, compare_branches_tags, और search_files_by_content का उपयोग करके।
  • रिलीज़ और फोर्क प्रबंधित करें — रिलीज़ बनाएं, मौजूदा रिलीज़ सूचीबद्ध करें, या रिपॉजिटरी को फोर्क करें, create_release, list_releases, और fork_repository के माध्यम से।
  • खोजें और खोजें — Gitee पर ओपन सोर्स रिपॉजिटरी या उपयोगकर्ता खोजें, search_open_source_repositories और search_users के साथ।
  • सूचनाएँ ट्रैक करेंlist_user_notifications के साथ अपनी नवीनतम सूचनाएँ जाँचें।

दस्तावेज़

Gitee MCP सर्वर

Gitee MCP सर्वर Gitee के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर कार्यान्वयन है। यह Gitee के API के साथ इंटरैक्ट करने के लिए उपकरणों का एक सेट प्रदान करता है, जिससे AI सहायक रिपॉजिटरी, इश्यू, पुल रिक्वेस्ट और अधिक प्रबंधित कर सकते हैं।

Install MCP Server

विशेषताएँ

  • Gitee रिपॉजिटरी, इश्यू, पुल रिक्वेस्ट और सूचनाओं के साथ इंटरैक्ट करें
  • विभिन्न Gitee इंस्टेंस का समर्थन करने के लिए कॉन्फ़िगर करने योग्य API बेस URL
  • आसान कॉन्फ़िगरेशन के लिए कमांड-लाइन फ्लैग
  • व्यक्तिगत, संगठन और उद्यम संचालन दोनों का समर्थन करता है
  • डायनामिक टूलसेट सक्षम/अक्षम
व्यावहारिक परिदृश्य: रिपॉजिटरी से इश्यू प्राप्त करें, कार्यान्वित करें और पुल रिक्वेस्ट बनाएं
  1. रिपॉजिटरी इश्यू प्राप्त करें get_repo_issues
  2. इश्यू विवरण के आधार पर कोडिंग कार्यान्वित करें और पुल रिक्वेस्ट बनाएं implement_issue
  3. टिप्पणी करें और इश्यू बंद करें comment_and_close_issue

स्थापना

रिमोट MCP सर्वर को किसी स्थापना की आवश्यकता नहीं है और यह तुरंत काम करता है। mcp-gitee को स्थानीय रूप से (stdio) चलाने के लिए, नीचे दिए गए विकल्पों में से एक चुनें।

रिमोट MCP सर्वर (अनुशंसित)

अपने होस्ट कॉन्फ़िगर के mcpServers अनुभाग में निम्नलिखित जोड़ें, <your personal access token> को यहाँ से प्राप्त टोकन से बदलें:

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

प्रति-क्लाइंट कॉन्फ़िग फ़ाइल पथ और प्रारूपों (Claude Code, Codex, Cursor, Trae, Cline, Continue, opencode) के लिए, नीचे MCP होस्ट्स कॉन्फ़िगरेशन अनुभाग में लिंक किए गए गाइड का पालन करें।

स्थानीय (stdio)

पूर्व-निर्मित बाइनरी डाउनलोड करें

अपने प्लेटफ़ॉर्म (linux-amd64 / linux-arm / darwin-amd64 / darwin-arm64 / windows-amd64) के लिए रिलीज़ से संग्रह प्राप्त करें, इसे निकालें, और mcp-gitee को अपने PATH पर रखें (Windows पर निष्पादन योग्य mcp-gitee.exe है)।

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>"
      }
    }
  }
}

स्रोत से निर्माण

Go 1.23.0 या उच्चतर की आवश्यकता है।

  1. रिपॉजिटरी क्लोन करें:

    git clone https://gitee.com/oschina/mcp-gitee.git
    cd mcp-gitee
    
  2. प्रोजेक्ट बनाएं:

    make build
    

    ./bin/mcp-gitee को PATH env में ले जाएं

go install का उपयोग करें

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

स्थापित निष्पादन योग्य का उपयोग करें

एक बार mcp-gitee आपके PATH पर उपलब्ध हो (रिलीज़, स्रोत निर्माण, या go install के माध्यम से):

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

Windows: निष्पादन योग्य में .exe प्रत्यय शामिल होना चाहिए, और command में पथ को फॉरवर्ड स्लैश / का उपयोग करना चाहिए (Windows उन्हें स्वीकार करता है, और यह JSON बैकस्लैश-एस्केपिंग गलतियों से बचाता है):

{
  "mcpServers": {
    "gitee": {
      "command": "C:/Users/<you>/bin/mcp-gitee.exe",
      "env": {
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

MCP होस्ट्स कॉन्फ़िगरेशन

कॉन्फ़िग उदाहरण: अधिक एप्लिकेशन कॉन्फ़िगरेशन देखने के लिए क्लिक करें

कमांड-लाइन विकल्प

  • --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 प्राथमिकता लेता है
  • उपकरण नाम केस-संवेदी हैं

प्रति-अनुरोध उपकरण फ़िल्टरिंग (HTTP हेडर)

रिमोट MCP सर्वर (HTTP/SSE ट्रांसपोर्ट) का उपयोग करते समय, आप HTTP हेडर के माध्यम से प्रति-अनुरोध आधार पर उपलब्ध उपकरणों को गतिशील रूप से फ़िल्टर कर सकते हैं। यह उन क्लाइंट्स के लिए उपयोगी है जिन्हें सर्वर को पुनरारंभ किए बिना उपकरण एक्सपोज़र पर सूक्ष्म-नियंत्रण की आवश्यकता होती है।

  1. हेडर के माध्यम से निर्दिष्ट उपकरण सक्षम करें (व्हाइटलिस्ट):

    • X-MCP-Enabled-Tools हेडर का उपयोग करें
    • केवल सूचीबद्ध उपकरण उस अनुरोध के लिए सक्षम होंगे
    • उदाहरण: X-MCP-Enabled-Tools: list_user_repos,get_file_content
  2. हेडर के माध्यम से निर्दिष्ट उपकरण अक्षम करें (ब्लैकलिस्ट):

    • X-MCP-Disabled-Tools हेडर का उपयोग करें
    • सूचीबद्ध उपकरण उस अनुरोध के लिए अक्षम होंगे
    • उदाहरण: X-MCP-Disabled-Tools: create_repo,delete_repo

प्राथमिकता नियम:

  • यदि एक ही अनुरोध में X-MCP-Enabled-Tools और X-MCP-Disabled-Tools दोनों मौजूद हैं, तो व्हाइटलिस्ट (X-MCP-Enabled-Tools) प्राथमिकता लेता है
  • उपकरण नाम केस-संवेदी हैं

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"
      }
    }
  }
}

लाइसेंस

यह प्रोजेक्ट MIT लाइसेंस के तहत लाइसेंस प्राप्त है। अधिक विवरण के लिए LICENSE फ़ाइल देखें।

उपलब्ध उपकरण

सर्वर Gitee के साथ इंटरैक्ट करने के लिए विभिन्न उपकरण प्रदान करता है:

उपकरणश्रेणीविवरण
list_user_reposरिपॉजिटरीउपयोगकर्ता के अधिकृत रिपॉजिटरी सूचीबद्ध करें
get_file_contentरिपॉजिटरीरिपॉजिटरी में फ़ाइल की सामग्री प्राप्त करें
create_repoरिपॉजिटरीरिपॉजिटरी बनाएं (उपयोगकर्ता, संगठन, या उद्यम)
fork_repositoryरिपॉजिटरीरिपॉजिटरी फोर्क करें
create_releaseरिपॉजिटरीरिपॉजिटरी के लिए रिलीज़ बनाएं
list_releasesरिपॉजिटरीरिपॉजिटरी रिलीज़ सूचीबद्ध करें
search_open_source_repositoriesरिपॉजिटरीGitee पर ओपन सोर्स रिपॉजिटरी खोजें
search_files_by_contentरिपॉजिटरीरिपॉजिटरी में सामग्री द्वारा फ़ाइलें खोजें
compare_branches_tagsरिपॉजिटरीरिपॉजिटरी में दो शाखाओं, टैग या कमिट की तुलना करें
list_repo_pullsपुल रिक्वेस्टरिपॉजिटरी में पुल रिक्वेस्ट सूचीबद्ध करें
merge_pullपुल रिक्वेस्टपुल रिक्वेस्ट मर्ज करें
create_pullपुल रिक्वेस्टपुल रिक्वेस्ट बनाएं
update_pullपुल रिक्वेस्टपुल रिक्वेस्ट अपडेट करें
get_pull_detailपुल रिक्वेस्टपुल रिक्वेस्ट का विवरण प्राप्त करें
get_diff_filesपुल रिक्वेस्टपुल रिक्वेस्ट डिफ़ फ़ाइलें प्राप्त करें
manage_pull_reviewपुल रिक्वेस्टपुल रिक्वेस्ट समीक्षा प्रबंधित करें (अनुमोदन या रद्द करें)
create_commentटिप्पणीइश्यू या पुल रिक्वेस्ट पर टिप्पणी बनाएं
list_commentsटिप्पणीइश्यू या पुल रिक्वेस्ट के लिए सभी टिप्पणियाँ सूचीबद्ध करें
create_issueइश्यूइश्यू बनाएं
update_issueइश्यूइश्यू अपडेट करें
get_repo_issue_detailइश्यूरिपॉजिटरी इश्यू का विवरण प्राप्त करें
list_repo_issuesइश्यूरिपॉजिटरी इश्यू सूचीबद्ध करें
get_user_infoउपयोगकर्तावर्तमान प्रमाणित उपयोगकर्ता जानकारी प्राप्त करें
search_usersउपयोगकर्ताउपयोगकर्ताओं को खोजें
list_user_notificationsसूचनाउपयोगकर्ता सूचनाएँ सूचीबद्ध करें

योगदान

हम ओपन-सोर्स समुदाय से योगदान का स्वागत करते हैं! यदि आप इस प्रोजेक्ट में योगदान देना चाहते हैं, तो कृपया इन दिशानिर्देशों का पालन करें:

  1. रिपॉजिटरी फोर्क करें।
  2. अपनी सुविधा या बग फिक्स के लिए एक नई शाखा बनाएं।
  3. अपने परिवर्तन करें और सुनिश्चित करें कि कोड अच्छी तरह से प्रलेखित है।
  4. अपने परिवर्तनों के स्पष्ट विवरण के साथ एक पुल रिक्वेस्ट सबमिट करें।

अधिक जानकारी के लिए, कृपया CONTRIBUTING फ़ाइल देखें।