worktrack-port

worktrack-port

Jira の課題と Confluence のページを MCP ツールとして提供し、 Atlassian REST API と通信します。worktrack-port は、Atlassian リモート MCP サーバーの主要な機能を、新しい名前でクリーンルーム方式により再構築したものです。 ツール名と通信上の動作は同じですが、コードは新規で、ブランドはコピーしていません。 元のものはホスト型のリモート MCP サーバーですが、この再構築版は同じ上流 API に対応した REST 互換クライアントです。ホスト型の OAuth 機能は再現していません。

ツール（主要なサブセット、12 個）

Jira：search_issues、get_issue、create_issue、update_issue、 add_comment、list_projects、get_project。 Confluence：search_content、get_page、create_page、 update_page、list_spaces。

このサブセットに含まれないもの：Jira のボード／スプリント／アジャイル機能、ワークフローと トランジションの管理、ユーザー／グループの管理、添付ファイル、ダッシュボードと フィルター、サービスデスク。Confluence の添付ファイル、ラベル、権限、 子ページ／祖先ページの操作、ブログ投稿、スペースの作成／削除。

プレーンテキストの課題の説明とコメントは、送信前に Atlassian Document Format（ADF）へ変換されます。

セットアップ

アカウント用の Atlassian API トークンを作成し、次のように設定します。

export [email protected]
export ATLASSIAN_API_TOKEN=...
export ATLASSIAN_SITE_URL=https://your-site.atlassian.net

いずれかの変数が設定されていない場合、すべてのツール呼び出しは、 不足している変数の名前を示すエラーで失敗します（EMAIL、API_TOKEN、 SITE_URL の順に確認されます）。

CLI

npx @reneturcios/worktrack-port search_issues '{"jql":"project = ABC"}'
npx @reneturcios/worktrack-port mcp        # stdio MCP server

各ツール名はサブコマンドであり、引数として 1 つの JSON オブジェクトを受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "worktrack-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/worktrack-port", "mcp"],
      "env": {
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "...",
        "ATLASSIAN_SITE_URL": "https://your-site.atlassian.net"
      }
    }
  }
}

Docker

docker run -i -e ATLASSIAN_EMAIL -e ATLASSIAN_API_TOKEN -e ATLASSIAN_SITE_URL ghcr.io/cloudcorprecords/worktrack-port

開発

npm install
npm run build
npm test

ライセンス

MIT