Specif-ai MCP 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
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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.3or 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.3Or 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.3Updates
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 -cTo 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 | iexTo 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.3Example 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 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
Available Tools
9 toolsget-bpsC
Get Business Process Documents for this project
Inputs: cwd (required).
get-brdsC
Get Business Requirement Documents for this project
Inputs: cwd (required).
get-nfrsC
Get Non-Functional Requirement Documents for this project
Inputs: cwd (required).
get-prdsC
Get Product Requirement Documents for this project
Inputs: cwd (required).
get-taskC
Get a Task for a particular User Story in a particular PRD
Inputs: cwd (required), prdId (required), taskId (required), userStoryId (required).
get-tasksC
Get Tasks for a particular User Story
Inputs: cwd (required), prdId (required), userStoryId (required).
get-uirsC
Get User Interface Requirement Documents for this project
Inputs: cwd (required).
get-user-storiesC
Get User Stories for a particular PRD
Inputs: cwd (required), prdId (required).
set-project-pathB
Set the project path and reload the solution, use this tool only when we not automatically able to infer the project path or asked by the user or us., we will try to auto infer it from the environment first.
Inputs: path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools have clear distinctions based on document types (e.g., BPS, BRDs, NFRS, PRDs, UIRs) and resource levels (e.g., tasks vs. user stories), but there is some overlap between 'get-task' and 'get-tasks' that could cause confusion about when to use each. The 'set-project-path' tool is distinct in purpose but stands out from the retrieval-focused tools.
The naming follows a consistent verb-object pattern with hyphens (e.g., 'get-bps', 'get-brds'), which is clear and predictable across most tools. However, 'set-project-path' deviates slightly by using 'set' instead of 'get', but it still maintains the same hyphenated structure, keeping it mostly consistent.
With 9 tools, the count is well-scoped for a document and project management server, covering various requirement documents, tasks, and user stories without being overwhelming. Each tool appears to serve a specific purpose, making the set manageable and focused.
The toolset provides good retrieval coverage for documents, tasks, and user stories, but there are notable gaps in CRUD operations, such as creating, updating, or deleting these resources. For a server focused on project requirements, the lack of write operations limits its completeness for full lifecycle management.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Generate a typed SDK, CLI, and MCP server from any OpenAPI or GraphQL spec, and keep them current.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.35-
- AlicenseCqualityDmaintenanceA Model Context Protocol implementation that provides a standardized interface for task management, supporting both STDIO mode for CLI/AI applications and HTTP+SSE mode for browser-based clients.411MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that captures and manages stdout logs through named pipes, making application output available for querying and debugging in AI tools like Cursor IDE.147 npm6ISC
- AlicenseNot gradedqualityDmaintenanceA powerful executable server for running Model Context Protocol services that supports tool chain execution, multiple MCP services management, and a pluggable tool system for complex automation workflows.38 npm176MIT