Gitee

Gitee MCP सर्वर

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

विशेषताएँ

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

व्यावहारिक परिदृश्य: रिपॉजिटरी से मुद्दा प्राप्त करें, कार्यान्वित करें और पुल अनुरोध बनाएँ

1. रिपॉजिटरी मुद्दे प्राप्त करें
2. कोडिंग कार्यान्वित करें और मुद्दे के विवरण के आधार पर पुल अनुरोध बनाएँ
3. टिप्पणी करें और मुद्दा बंद करें

स्थापना (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 env में ले जाएँ

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

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

उपयोग

mcp-gitee संस्करण जाँचें:

mcp-gitee --version

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

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

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

दूरस्थ MCP सर्वर

आधिकारिक दूरस्थ mcp-gitee सर्वर से कनेक्ट करें (कोई स्थापना आवश्यक नहीं):

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

Codex ~/.codex/config.toml का उपयोग करता है:

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

opencode ~/.config/opencode/opencode.json का उपयोग करता है:

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

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

• --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 फ़ाइल देखें।