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
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.
@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
Related MCP server: Task API Server
Installation
Direct Binary Installation (Recommended)
You can install the binary directly using our installation script:
or manually download the binary for your platform from the Releases page.
Package Manager Installation
You can install globally using npm:
Or using bun:
Updates
To check for updates:
To update to the latest version:
To update to a specific version:
Example MCP Client Configuration
with npx with latest version:
with npx with specific version:
with bunx with latest version:
with bunx with specific version:
with direct binary or package manager global installation:
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:
Available Tools
The server provides several tools for interacting with your specification documents:
Tool Name | Description |
| Set or change the project directory path |
| Get Business Requirement Documents |
| Get Product Requirement Documents |
| Get Non-Functional Requirements |
| Get User Interface Requirements |
| Get Business Process Documents |
| Get User Stories for a specific PRD |
| Get Tasks for a specific User Story |
| 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