Git MCP Server 225

🚀 Git MCP 服務器

一個實現模型上下文協議 (MCP) 的服務器，為大型語言模型提供全面的 Git 功能，使其能夠通過安全且標準化的接口執行版本控制操作。

🚀 快速開始

Git MCP Server 實現了由 Anthropic 創建的 Model Context Protocol (MCP)，該協議為大型語言模型和外部系統之間的通信提供了一個標準化接口。其架構包含客戶端（如 Claude Desktop、IDE）、服務器以及 LLMs，能在 LLM 和外部系統之間創建安全邊界，同時提供對 Git 功能的受控訪問。

安裝步驟

1. 克隆存儲庫

   git clone [repository-url]
   cd mcp-git-server
   

2. 安裝依賴項

   npm install
   

3. 啟動開發服務器（可選）

   npm run dev
   

配置環境變量

• PORT：指定服務運行的端口，默認為 3000。
• DEBUG：啟用調試模式，值設為 true。

# 啟動時設置環境變量
PORT=3001 DEBUG=true npm start

✨ 主要特性

核心 Git 操作

• 倉庫初始化和克隆
• 文件階段化和提交
• 分支管理
• 遠端操作
• 標籤處理
• 複製存檔

批量操作

• 順序操作執行
• 原子提交
• 智能默認值
• 錯誤恢復

安全功能

• 路徑驗證
• 倉庫狀態驗證
• 嵌入式倉庫處理
• 全面錯誤報告

📦 安裝指南

設置步驟

1. 克隆存儲庫

   git clone [repository-url]
   cd mcp-git-server
   

2. 安裝依賴項

   npm install
   

3. 啟動開發服務器（可選）

   npm run dev
   

📚 詳細文檔

配置

環境變量

• PORT：指定服務運行的端口，默認為 3000。
• DEBUG：啟用調試模式，值設為 true。

# 啟動時設置環境變量
PORT=3001 DEBUG=true npm start

工具

安裝依賴

npm install express mcp-router

最佳實踐

• 路徑管理：始終使用絕對路徑，避免相對路徑。
• 錯誤處理：在每次操作後檢查結果，並記錄日誌或報告錯誤。

開發

# 構建項目
npm run build

# 監視文件變化
npm run watch

# 運行 MCP 檢查工具
npm run inspector

錯誤處理

服務器提供詳細的錯誤信息：

• 無效的路徑或參數
• Git 命令失敗
• 倉庫狀態錯誤
• 權限問題

貢獻

歡迎貢獻！請按照以下步驟操作：

1. ** Fork 代碼庫**
2. ** 創建功能分支**
3. ** 提交更改**
4. ** 推送到分支**
5. ** 創建 Pull Request**

對於 bug 和功能請求，請創建 issue。

接下來計劃

暫未提及具體內容，但可期待後續更新。

📄 許可證

Apache License 2.0