MCP Monday Server

🚀 Monday.com MCP サーバー

軽量なMCPサーバーで、Monday.comとのシームレスな統合を実現し、MCPクライアントがMonday.comのリソース（看板、アイテムなど）と相互作用できるようにします。sofias techによって開発されました。

🚀 クイックスタート

このサーバーは、Model Context Protocol (MCP) を通じてMonday.comのリソースに対するクリーンなインターフェースを提供し、パフォーマンス向上のためのキャッシュ機能も内蔵しています。

インストール

pip install -e .

または、PyPIで公開された後は以下のコマンドでインストールできます。

pip install mcp-monday-server

uvを使用する場合：

uv pip install mcp-monday-server

Claude Desktop 統合

Claude Desktopで統合するには、設定ファイルを更新します。

• Windows：%APPDATA%/Claude/claude_desktop_config.json
• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json

標準統合

"mcpServers": {
  "monday": {
    "type": "stdio",
    "command": "python3",
    "args": ["-m", "mcpy"]
  }
}

uv 統合

uv add mcpy -- python3 -m mcpy

✨ 主な機能

このサーバーは、Model Context Protocol (MCP) を介してMonday.comのリソースに対するクリーンなインターフェースを提供し、パフォーマンス向上のためにキャッシュ機能を内蔵しています。

ツール

このサーバーは以下のツールを実装しています。

• Get_Board_Schema：指定された看板のスキーマ（列、グループ、ラベルを含む）を取得します。
• Get_Item_Details：アイテムIDに基づいて詳細情報を取得します。
• Get_Items_by_Column_Value：特定の列の値に基づいてアイテムを検索します。
• Create_Item：指定されたグループ内に新しいアイテムを作成します。
• Update_Item：既存のアイテムの列の値を更新します。
• Delete_Item：指定された看板内のアイテムを削除します。

🔧 技術詳細

このサーバーは、リソース効率を重視して設計されています。

• リソース管理とツールの実装が明確に分離されています。
• 簡単で保守しやすいコードベース（各モジュールは30行以内）。

📦 インストール

1. Monday.comで個人用APIトークンを作成します。Monday.com APIドキュメントの手順に従ってください。
2. Monday.comの看板URLから看板IDを取得します（例えば、URLがhttps://your-workspace.monday.com/boards/12345678の場合、看板IDは12345678です）。

環境変数

サーバーには以下の環境変数が必要です。

• MONDAY_API_KEY：Monday.comの個人用APIトークン
• MONDAY_BOARD_ID：デフォルトで使用する看板ID

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。