Teamretro MCP Server

🚀 チームレトロ MCP サーバー

モデルコンテキストプロトコル（MCP）サーバーは、チームレトロの統合に使用されます。

🚀 クイックスタート

このチームレトロ MCP サーバーを使用することで、チームレトロのプラットフォームに標準的なアクセスが可能になります。以下に、使用方法や注意事項を詳しく説明します。

✨ 主な機能

• 非公式な MCP サーバーですが、チームレトロのプラットフォームに標準的なアクセス方法を提供します。
• チームレトロの公式公共 API に直接接続し、完全な API 互換性とバージョン追跡を維持します。
• ユーザー管理、プロジェクト管理、タスク管理などの機能を提供します。

⚠️ 重要注意事項

非公式 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 サーバーの機能に影響を与える可能性があります。

📦 インストール

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 index.js

環境変数の設定

基本設定

# 設定ファイルのパス
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：タスクを削除します。

コードサンプル

新しいユーザーを作成する

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}`);
}

📚 ドキュメント

よくある質問

1. 依存関係をインストールするにはどうすればよいですか？
   • npm を使用してインストールします。

     npm install
     

2. サーバーを起動するにはどうすればよいですか？
   • メインファイルを実行します。

     node index.js
     

3. サーバーを構成するにはどうすればよいですか？
   • config.json ファイルを作成し、適切なパラメーターを設定します。

まとめ

以上の手順に従って、チームレトロ MCP サーバーを簡単に構成して実行することができます。ユーザー管理、プロジェクト管理、タスク管理など、強力な機能を提供します。

ご丁寧に読んでいただき、ありがとうございます！これらの情報がお役に立てば幸いです。他に質問がある場合は、ドキュメントを参照するか、お問い合わせください。