English Français العربية

io.github.Inflectra/mcp-server-spira

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-server-spira
Claude Code 
claude mcp add mcp-server-spira -e 'INFLECTRA_SPIRA_BASE_URL=<INFLECTRA_SPIRA_BASE_URL>' -e 'INFLECTRA_SPIRA_USERNAME=<INFLECTRA_SPIRA_USERNAME>' -e 'INFLECTRA_SPIRA_API_KEY=<your inflectra_spira_api_key>' -- uvx mcp-server-spira==1.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-server-spira": {
            "command": "uvx",
            "args": [
                "mcp-server-spira==1.1.1"
            ],
            "env": {
                "INFLECTRA_SPIRA_BASE_URL": "<INFLECTRA_SPIRA_BASE_URL>",
                "INFLECTRA_SPIRA_USERNAME": "<INFLECTRA_SPIRA_USERNAME>",
                "INFLECTRA_SPIRA_API_KEY": "<your inflectra_spira_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • INFLECTRA_SPIRA_BASE_URL إلزامي The base URL for your instance of Spira (typically https://mycompany.spiraservice.net or https://demo-xx.spiraservice.net/mycompany)
  • INFLECTRA_SPIRA_USERNAME إلزامي The login name you use to access Spira
  • INFLECTRA_SPIRA_API_KEY إلزامي سري The API Key (RSS Token) you use to access the Spira REST API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP Inflectra Spira Server
  2. Table of Contents
  3. Quick Start
  4. Configuration
  5. Available Tools
  6. Usage Examples
  7. License

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:

pip install mcp-server-spira

Add to your MCP client config:

{
  "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:

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

الأسئلة الشائعة

ما هو io.github.Inflectra/mcp-server-spira؟

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

كيف أثبّت io.github.Inflectra/mcp-server-spira؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-server-spira -e 'INFLECTRA_SPIRA_BASE_URL=<INFLECTRA_SPIRA_BASE_URL>' -e 'INFLECTRA_SPIRA_USERNAME=<INFLECTRA_SPIRA_USERNAME>' -e 'INFLECTRA_SPIRA_API_KEY=<your inflectra_spira_api_key>' -- uvx mcp-server-spira==1.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Inflectra/mcp-server-spira إلى مفتاح API؟

نعم. يتطلب INFLECTRA_SPIRA_BASE_URL, INFLECTRA_SPIRA_USERNAME, INFLECTRA_SPIRA_API_KEY، وتضبطها في إعداداته.

هل io.github.Inflectra/mcp-server-spira مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Inflectra/mcp-server-spira؟

ينشره Inflectra. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.