Wekan Mcp

Wekan MCP サーバー

GoAIX にて namar0x0309 が ❤️ を込めて作成

このプロジェクトには、Wekan API トークンを自動生成し、環境を設定するスクリプトが含まれています。

対応するエージェント機能

Wekan MCP サーバーは、AI エージェントが Wekan を操作するために以下のツールを提供します。

ボード管理

• listBoards - 認証済みユーザーがアクセスできるすべての Wekan ボードを一覧表示します

リスト管理

• listLists - 指定したボード内のすべてのリストを一覧表示します

スイムレーン管理

• listSwimlanes - ボード内のすべてのスイムレーンを一覧表示します（カードを縦方向に整理するために使用します）

カード管理

• listCards - 指定したボードとリスト内のすべてのカードを一覧表示します
• createCard - 以下に対応した新しいカードを作成します。
  • タイトル（必須）
  • 説明（任意）
  • スイムレーンの割り当て（任意）
  • 期限（任意、ISO 8601 の日時形式）
  • チームメンバー（任意、ユーザー ID の配列）
  • ラベル（任意、ラベル ID の配列）
• moveCard - 同じボード内の別のリストまたはスイムレーンにカードを移動します

カードの操作

• commentCard - 既存のカードにコメントを追加します

はじめに

Wekan API トークンを生成する

ご利用のプラットフォームに応じたスクリプトを実行して、API トークンを生成します。

Windows（PowerShell）：

./get-wekan-token.ps1

Linux/macOS（Bash）：

./get-wekan-token.sh

スクリプトによって、以下の入力を求められます。

• Wekan のエンドポイント（例：https://wekan.namar0x0309.com）
• ユーザー名
• パスワード

認証に成功すると、以下が実行されます。

1. API トークンを生成します
2. トークンと設定を含む .env ファイルを作成または更新します

手動での設定

手動で設定する場合は、.env.example を .env にコピーし、詳細を入力します。

cp .env.example .env

次に .env ファイルを編集し、Wekan インスタンスの詳細と API トークンを設定します。

環境変数

.env ファイルには以下が含まれます。

• WEKAN_BASE_URL：Wekan インスタンスの URL
• WEKAN_API_TOKEN：認証用に生成された API トークン
• WEKAN_USERNAME：Wekan のユーザー名（API トークンの代わりに使用）
• WEKAN_PASSWORD：Wekan のパスワード（API トークンの代わりに使用）
• WEKAN_USER_ID：Wekan のユーザー ID
• WEKAN_TOKEN_EXPIRES：トークンの有効期限

注： 以下のいずれかの方法で認証できます。

1. WEKAN_API_TOKEN - 事前に生成されたトークン、または
2. WEKAN_USERNAME と WEKAN_PASSWORD - リクエストごとにトークンを自動生成する場合

テスト

以下を実行して、設定をテストできます。

node test-auth.js

これにより、API トークンが正しく動作していることを確認できます。

利用可能なすべてのメソッドをテストすることもできます。

node test-all-methods.js

開発

MCP Inspector

MCP サーバーの開発とデバッグには、MCP Inspector を使用できます。

npm run inspect

これにより、mcp-inspector-config.json の設定を使用して MCP Inspector が起動します。

自動再ビルドを有効にして開発するには、以下を実行します。

npm run inspect:watch

これにより、プロジェクトをビルドして Inspector を起動し、変更を検出すると自動的に再ビルドします。