Mcp Server Spira

io.github.Inflectra由 GitHub 帳號 Inflectra 發布v1.1.1更新於 Oct 24, 2026

A Model Context Protocol (MCP) server enabling AI assistants to interact with Spira by Inflectra.

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理連接 Inflectra Spira，進行專案、測試與需求管理。

可以做什麼
  • 搜尋與讀取工件：指派給自己的項目、產品內 11 類工件、方案層級的能力與里程碑、依 ID 取得單一工件
  • 建立與更新工件，例如事件、任務、需求、測試案例、風險、版本、建置與測試步驟
  • 記錄自動化測試執行結果，並為工件新增留言
  • 以關聯關係（相關、相依、涵蓋）連結兩個工件
  • 瀏覽工作區：列出或取得產品、方案與範本，讀取範本中繼資料
  • 在本機檢視各類工件的欄位結構，無需呼叫 API
適用情境
適合團隊在 SpiraTest、SpiraTeam 或 SpiraPlan 中管理專案、需求與測試案例，並希望助理在對話或 CI/CD 中查詢待辦事項、跨產品搜尋、提交或更新工件與測試結果的情境。
執行需求
以 Python 套件形式在本機透過 stdio 執行（pip install mcp-server-spira），需要 Python 環境。需設定三個環境變數：INFLECTRA_SPIRA_BASE_URL、INFLECTRA_SPIRA_USERNAME 與 INFLECTRA_SPIRA_API_KEY（來自 Spira 使用者設定的 RSS 權杖）。選用 SPIRA_PROJECT_ID、SPIRA_CREATE_TAGS、SPIRA_UPDATE_TAGS。需能連線至 Spira 執行個體的網路。
安裝前請注意
API 金鑰是個人存取權杖，會存放在用戶端設定或 .env 檔案中，請妥善保管。寫入類工具會在你的 Spira 執行個體中建立與更新工件、記錄測試執行、新增留言與關聯；SPIRA_CREATE_TAGS 或 SPIRA_UPDATE_TAGS 會讓助理寫入的所有內容自動附加標籤。所有查詢與變更都會傳送到你的 Spira 伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Server Spira，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP Inflectra Spira Server

A Model Context Protocol (MCP) server that lets AI assistants interact with Inflectra Spira — covering project management, test management, and requirements management.

Works with SpiraTest, SpiraTeam, and SpiraPlan.

Table of Contents

Quick Start

Install from PyPI:

bash
pip install mcp-server-spira

Add to your MCP client config:

json
{  "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}"      }    }  }}

For Cline, add "type": "stdio" to the server config. For Claude Desktop:

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

Configuration

Set these environment variables (or use a .env file):

VariableRequiredDescription
INFLECTRA_SPIRA_BASE_URLYesBase URL for your Spira instance
INFLECTRA_SPIRA_USERNAMEYesYour Spira login name
INFLECTRA_SPIRA_API_KEYYesAPI Key (RSS Token) from your Spira user profile
SPIRA_PROJECT_IDNoDefault product ID — avoids passing product_id on every call
SPIRA_CREATE_TAGSNoComma-separated tag string merged into Tags on every artifact the MCP creates; empty or unset disables injection
SPIRA_UPDATE_TAGSNoComma-separated tag string merged into Tags on every artifact the MCP updates; empty or unset disables injection

Available Tools

13 tools organized by scope. All data-retrieval tools return structured JSON with field projection, filtering, and a consistent response envelope.

Search Tools

ToolDescription
mywork_search_artifactsYour assigned items (task, incident, requirement, test_case, test_set) with filtering and field projection
product_search_artifactsSearch artifacts in a product (11 types). Supports cross-product fan-out, server-side filtering, and nested sub-artifact includes.
product_get_artifactSingle artifact by ID with full details and optional sub-artifact includes
program_search_artifactsSearch program-level artifacts (capability, milestone)

Write Tools

ToolDescription
product_create_artifactCreate artifacts (incident, task, requirement, test_case, risk, release, test_set, build, test_step, mitigation, requirement_step)
product_update_artifactUpdate existing artifacts
product_record_test_runRecord automated test results from CI/CD
create_commentAdd a comment to an artifact
create_associationLink two artifacts (related-to, depends-on, coverage)

Workspace & Configuration Tools

ToolDescription
workspace_searchList products, programs, or product templates with field projection
workspace_getGet a single product, program, or template by ID
template_get_metadataTypes, statuses, priorities, severities, custom properties, and more for a template
get_artifact_schemaField schema for any artifact type (local-only, no API call)

Usage Examples

Try these prompts with your AI assistant:

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

License

MIT — see LICENSE.

Built with MCP Python SDK · Spira REST API v7.0

來源：README.md，提交 ebbc26f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分