Teamretro MCP Server

🚀 團隊復古 MCP 服務器

模型上下文協議（MCP）服務器用於團隊復古集成，為團隊復古平臺提供了一種標準的訪問途徑。

🚀 快速開始

此 MCP 服務器是團隊復古社區開發的非官方接口，雖未由團隊復古開發或認可，但提供了對其平臺的標準訪問方式。它直接連接到團隊復古的官方公共 API，嚴格遵循其規範。

使用 NPX（推薦，簡單設置）

{
  "mcpServers": {
    "teamretro-mcp-server": {
      "command": "npx",
      "args": []
    }
  }
}

安裝

1. 克隆倉庫：

   git clone https://github.com/yourusername/teamretro-mcp-server.git
   cd teamretro-mcp-server
   

2. 安裝依賴項：

   npm install
   

運行

使用 Node.js 運行服務器：

node index.js

✨ 主要特性

非官方 MCP 服務器

此 MCP 服務器是團隊復古社區開發的非官方接口。儘管不是由團隊復古開發或認可，但它提供了對其平臺的標準訪問方式。

正式 API 集成

• 該服務器直接連接到團隊復古的官方公共 API，使用了團隊復古 API 文檔中記錄的端點。
• 保持完整的 API 兼容性和版本跟蹤。
• 實現了所有必需的身份驗證方法。
• 保留原始 API 響應，不做任何修改。

API 文檔來源

• 所有 API 端點和功能均基於團隊復古的官方文檔：
  • API 幫助文章：https://help.teamretro.com/article/320 - teamretro - api
  • API 規範：https://groupmap.stoplight.io/docs/teamretro/
• 嚴格遵循公共 API 規範，團隊復古 API 的任何更改可能會影響此 MCP 服務器的功能。

💻 使用示例

基礎用法

創建新用戶

const { createUser } = require('teamretro-mcp-server');

async function main() {
  try {
    const response = await createUser({
      username: 'newuser',
      email: 'newuser@example.com',
      password: 'securepassword'
    });
    console.log(response);
  } catch (error) {
    console.error(error);
  }
}

main();

獲取項目詳情

const { getProject } = require('teamretro-mcp-server');

async function main() {
  try {
    const response = await getProject({
      projectId: '12345'
    });
    console.log(response);
  } catch (error) {
    console.error(error);
  }
}

main();

高級用法

配置日誌輸出

const winston = require('winston');
require('winston-daily-rotate-file');

const logger = new winston.Logger({
  transports: [
    new winston.ConsoleTransport(),
    new winston.DailyRotateFileTransport({
      filename: 'app.log',
      frequency: 'daily'
    })
  ]
});

logger.info('Server started successfully');

處理異常

try {
  // 執行操作
} catch (error) {
  logger.error(`Error occurred: ${error.message}`);
}

📚 詳細文檔

環境變量示例

基本配置

# 配置文件路徑
export CONFIG_PATH=./config.json

# 日誌級別
export LOG_LEVEL=info

高級配置

# 設置代理
export HTTP_PROXY=http://proxy.example.com:8080

# 禁用 SSL 認證
export NODE_NO_HTTPS_CHECK=true

工具列表

用戶管理

• create_user：創建新用戶
• get_user：獲取指定用戶信息
• update_user：更新用戶資料
• delete_user：刪除用戶

項目管理

• list_projects：列出所有項目
• create_project：創建新項目
• get_project：獲取項目詳情
• update_project：更新項目信息
• delete_project：刪除項目

任務管理

• list_tasks：列出所有任務
• create_task：創建新任務
• get_task：獲取任務詳情
• update_task：更新任務狀態
• delete_task：刪除任務

常見問題解答

1. 如何安裝依賴？
   • 使用 npm 安裝：

     npm install
     

2. 如何啟動服務器？
   • 運行主文件：

     node index.js
     

3. 如何配置服務器？
   • 創建 config.json 文件並設置相應參數。

🔧 技術細節

此 MCP 服務器直接連接到團隊復古的官方公共 API，使用了其文檔中記錄的端點，保持完整的 API 兼容性和版本跟蹤，實現了所有必需的身份驗證方法，保留原始 API 響應不做修改。所有 API 端點和功能均嚴格遵循團隊復古的官方文檔，團隊復古 API 的任何更改可能會影響此 MCP 服務器的功能。

總結

通過以上步驟，您可以輕鬆配置和運行團隊復古 MCP 服務器。無論是用戶管理、項目管理還是任務管理，該服務器都能為您提供強大的功能支持。

感謝您的耐心閱讀！希望這些信息對您有所幫助。如果還有其他問題，請隨時查閱文檔或與我們聯繫。

⚠️ 重要提示

此 MCP 服務器是團隊復古社區開發的非官方接口。儘管不是由團隊復古開發或認可，但它提供了對其平臺的標準訪問方式。團隊復古 API 的任何更改可能會影響此 MCP 服務器的功能。

💡 使用建議

建議使用 NPX 進行簡單設置。在配置服務器時，可創建 config.json 文件並設置相應參數。同時，注意配置日誌輸出和異常處理，以確保服務器的穩定運行。