@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
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
- Cline
- Cursor
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"
}
}
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