What can you do with this server?

The Specif-ai MCP Server is a CLI tool that facilitates interaction with specification documents stored in a project directory. With this server, you can: * Set or change the project directory path where specification files are located * Retrieve various types of documents including: * Business Requirement Documents (BRDs) * Product Requirement Documents (PRDs) * Non-Functional Requirements (NFRs) * User Interface Requirements (UIRs) * Business Process Documents (BPs) * Access User Stories associated with specific PRDs * Retrieve Tasks linked to specific User Stories * Get detailed information about individual Tasks

Which integrations are available for this server?

Provides installation and execution of the MCP server via Bun package manager and runtime, with specific commands for using bunx to run the server for improved performance. Uses Mermaid diagrams to visualize installation options and usage flows for the MCP server. Supports running the MCP server in Node.js environments with specific installation methods and version requirements. Enables installation and execution of the MCP server through npm package manager with version-specific installation options.

How do I use Specif-ai MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Specif-ai MCP Server set project path to ./specs and load all user stories" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@vj-presidio/specif-ai-mcp-server

A CLI tool that runs an MCP (Model Context Protocol) server over stdio for Specif-ai.

Installation & Usage Overview

graph TD
    A[Installation Options]

    A --> B[Direct Binary Installation]
    A --> C[Package Manager Installation]

    B --> D[Unix Script]
    B --> E[Windows PowerShell]

    C --> F[NPM Global]
    C --> G[Bun Global]

    B --> H1[When to Use Binary Installation]
    H1 --> I1[System-wide installation]
    H1 --> I2[No Node.js required]
    H1 --> I3[Minimal dependencies]

    C --> H2[When to Use Package Manager]
    H2 --> J1[Already using Node.js/Bun]
    H2 --> J2[Need automatic updates]
    H2 --> J3[Project-specific versions]

    K[Usage Methods]
    K --> L[Direct CLI]
    K --> M[NPX]
    K --> N[BunX]

    L --> O1[Installed globally]
    L --> O2[Fastest startup]

    M --> P1[No installation needed]
    M --> P2[Version flexibility]

    N --> Q1[Bun runtime users]
    N --> Q2[Better performance]

Related MCP server: Task API Server

Installation

Direct Binary Installation (Recommended)

You can install the binary directly using our installation script:

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.sh | sh

# Install specific version
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.sh | sh -s -- -v 1.2.3

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.ps1 | iex

# Install specific version
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/install.ps1 | iex -v 1.2.3

or manually download the binary for your platform from the Releases page.

Package Manager Installation

You can install globally using npm:

# Latest version
npm install -g @vj-presidio/specif-ai-mcp-server@latest
# Specific version
npm install -g @vj-presidio/specif-ai-mcp-server@1.2.3

Or using bun:

# Latest version
bun install -g @vj-presidio/specif-ai-mcp-server@latest
# Specific version
bun install -g @vj-presidio/specif-ai-mcp-server@1.2.3

Updates

To check for updates:

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh -s -- -c

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex -c

To update to the latest version:

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex

To update to a specific version:

# Unix (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.sh | sh -s -- -v 1.2.3

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/vj-presidio/specif-ai-mcp-server/main/update.ps1 | iex -v 1.2.3

Example MCP Client Configuration

with npx with latest version:

{
  "specif-ai": {
    "command": "npx",
    "args": ["--yes", "@vj-presidio/specif-ai-mcp-server@latest"],
    "disabled": false,
    "autoApprove": []
  }
}

with npx with specific version:

{
  "specif-ai": {
    "command": "npx",
    "args": ["--yes", "@vj-presidio/specif-ai-mcp-server@1.2.3"],
    "disabled": false,
    "autoApprove": []
  }
}

with bunx with latest version:

{
  "specif-ai": {
    "command": "bunx",
    "args": ["@vj-presidio/specif-ai-mcp-server@latest"],
    "disabled": false,
    "autoApprove": []
  }
}

with bunx with specific version:

{
  "specif-ai": {
    "command": "bunx",
    "args": ["@vj-presidio/specif-ai-mcp-server@1.2.3"],
    "disabled": false,
    "autoApprove": []
  }
}

with direct binary or package manager global installation:

{
  "specif-ai": {
    "command": "specif-ai-mcp-server",
    "args": [],
    "disabled": false,
    "autoApprove": []
  }
}

Options

--help, -h: Display help information
--version: Display version information

Specifai MCP integration with popular IDE and extension

See the setup instructions for each

Setting Project Path

Once the server is running, you can set the project path using the set-project-path tool. This tool accepts a path to the directory containing your specification files. After setting the path, the server will load all documents from that directory.

Example tool usage:

{
  "name": "set-project-path",
  "arguments": {
    "path": "./path/to/project"
  }
}

Available Tools

The server provides several tools for interacting with your specification documents:

Tool Name	Description
`set-project-path`	Set or change the project directory path
`get-brds`	Get Business Requirement Documents
`get-prds`	Get Product Requirement Documents
`get-nfrs`	Get Non-Functional Requirements
`get-uirs`	Get User Interface Requirements
`get-bps`	Get Business Process Documents
`get-user-stories`	Get User Stories for a specific PRD
`get-tasks`	Get Tasks for a specific User Story
`get-task`	Get details of a specific Task

Requirements

For binary installation:

curl (Unix) or PowerShell (Windows)
sudo access (Unix, for system-wide installation)

For package manager installation:

Node.js >= 16.0.0
Bun >= 1.0.0 (if using Bun runtime)

License

MIT

Specif-ai MCP Server