mcp-server-spira

MCP Inflectra Spira サーバー

AI アシスタントが Inflectra Spira と連携できる Model Context Protocol（MCP）サーバーです。プロジェクト管理、テスト管理、要件管理に対応しています。

SpiraTest、SpiraTeam、SpiraPlan で動作します。

---

目次

• クイックスタート
• 設定
• 利用可能なツール
• 使用例
• ライセンス

---

クイックスタート

PyPI からインストールします。

pip install mcp-server-spira

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "inflectra-spira": {
      "command": "python",
      "args": ["-m", "mcp_server_spira"],
      "env": {
        "INFLECTRA_SPIRA_BASE_URL": "https://myinstance.spiraservice.net",
        "INFLECTRA_SPIRA_USERNAME": "mylogin",
        "INFLECTRA_SPIRA_API_KEY": "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX}"
      }
    }
  }
}

Cline の場合は、サーバー設定に "type": "stdio" を追加します。Claude Desktop の場合は次のとおりです。

mcp install src/mcp_server_spira/server.py --name "Inflectra Spira Server"

---

設定

次の環境変数を設定します（または .env ファイルを使用します）。

変数	必須	説明
INFLECTRA_SPIRA_BASE_URL	はい	Spira インスタンスのベース URL
INFLECTRA_SPIRA_USERNAME	はい	Spira のログイン名
INFLECTRA_SPIRA_API_KEY	はい	Spira のユーザープロフィールにある API Key（RSS Token）
SPIRA_PROJECT_ID	いいえ	デフォルトの製品 ID。各呼び出しで product_id を渡す必要がなくなります
SPIRA_CREATE_TAGS	いいえ	MCP が作成するすべてのアーティファクトの Tags に追加される、カンマ区切りのタグ文字列。空または未設定の場合、追加されません
SPIRA_UPDATE_TAGS	いいえ	MCP が更新するすべてのアーティファクトの Tags に追加される、カンマ区切りのタグ文字列。空または未設定の場合、追加されません

---

利用可能なツール

スコープ別に整理された 13 個のツールです。データ取得ツールはすべて、フィールドの選択、フィルタリング、および一貫したレスポンス形式を備えた構造化 JSON を返します。

検索ツール

ツール	説明
mywork_search_artifacts	担当項目（task、incident、requirement、test_case、test_set）を、フィルタリングとフィールド選択を使って検索します
product_search_artifacts	製品内のアーティファクト（11 種類）を検索します。複数製品への横断検索、サーバー側フィルタリング、ネストされたサブアーティファクトの取得に対応しています。
product_get_artifact	ID を指定して単一のアーティファクトを詳細情報とともに取得します。サブアーティファクトも必要に応じて取得できます
program_search_artifacts	プログラムレベルのアーティファクト（capability、milestone）を検索します

書き込みツール

ツール	説明
product_create_artifact	アーティファクト（incident、task、requirement、test_case、risk、release、test_set、build、test_step、mitigation、requirement_step）を作成します
product_update_artifact	既存のアーティファクトを更新します
product_record_test_run	CI/CD から自動テストの結果を記録します
create_comment	アーティファクトにコメントを追加します
create_association	2 つのアーティファクトをリンクします（related-to、depends-on、coverage）

ワークスペースと設定ツール

ツール	説明
workspace_search	フィールド選択を使って、製品、プログラム、または製品テンプレートを一覧表示します
workspace_get	ID を指定して単一の製品、プログラム、またはテンプレートを取得します
template_get_metadata	テンプレートの種類、ステータス、優先度、重大度、カスタムプロパティなどを取得します
get_artifact_schema	任意のアーティファクトタイプのフィールドスキーマを取得します（ローカルのみ、API 呼び出しなし）

---

使用例

AI アシスタントで次のプロンプトを試してください。

Show me my assigned tasks in Spira

List all products in my Spira instance

Get the open incidents in product 55

Search for critical requirements across products 55 and 60

Get the field schema for incidents

---

ライセンス

MIT — LICENSE を参照してください。

MCP Python SDK · Spira REST API v7.0 を使用して構築しています。