specifai-mcp-server

MCP.Pizza Chef: presidio-oss

The specifai-mcp-server is an MCP server designed to integrate Specifai project requirements, tasks, and documents with any AI tools supporting the Model Context Protocol. It provides tool-agnostic access to all documents generated by Specifai, enabling seamless automation and interaction with MCP-compatible AI environments. Currently experimental, it aims to expand functionality for enhanced project integration and automation workflows.

Use This MCP server To

Expose Specifai project requirements to MCP-compatible AI tools Enable AI tools to read and process Specifai-generated documents Automate project task management using Specifai data via MCP Integrate Specifai project context into AI-assisted development workflows Facilitate multi-tool AI workflows with Specifai project data Support experimental automation of Specifai project documentation

README

Specifai MCP Server

A Model Context Protocol (MCP) server for Specifai project integration and automation with any MCP-compatible AI tool. This server is designed to work with tool agnostic, meaning it can be used with any tool that supports the MCP protocol. This server currently expose tools to read all documents generated by Specifai project.

Warning

This server is currently in experimental. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server.

License: MIT npm version

Table of Contents

Installation

# Latest version
npx --yes @presidio-dev/specifai-mcp-server@latest

# Specific version
npx --yes @presidio-dev/specifai-mcp-server@1.2.3

We recommend npx to install the server, but you can use any node package manager of your preference such as yarn, pnpm, bun, etc.

Configuration

with npx with latest version:

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

with npx with specific version:

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

Preparing your project

This is completely optional, but it's recommended to use it to avoid having to specify the project directory path every time you access the server. For AI IDE / Extension (Hai Build), it's recommended to use a .specifai-path file to specify the project directory path.

Make sure your project root directory contains a .specifai-path file. It's how the Specifai MCP server know where to find the specification documents generated by Specifai.

The file is a plain text file containing the absolute path to the project directory where the specification documents for an project are stored.

For example, if your project directory is located at /path/to/project, the .specifai-path file should contain the following line:

/path/to/project

Specifai MCP integration with popular IDE and extension

See the setup instructions for each

  1. Hai Build
  2. Cursor

Available Tools

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

Tool Name Description
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-bpds 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
set-project-path Set or change the project directory path
get-task-by-id Get details of a specific Task by ID
list-all-tasks List all available tasks
search Full text search across all documents

Requirements

Package manager installation:

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

Contributing

We welcome contributions to the Specifai MCP Server! Please see our Contributing Guide for more information on how to get started.

Development Setup

For detailed instructions on setting up your development environment, please refer to our Development Setup Guide.

Architecture

To understand the project architecture, please see our Architecture Guide.

Security

For information about our security policy and how to report security vulnerabilities, please see our Security Policy.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

  • Model Context Protocol - The protocol specification this server implements
  • Specifai - The project this server integrates with

specifai-mcp-server FAQ

How do I install the specifai-mcp-server?
Installation instructions are provided in the GitHub README, typically via npm package installation.
Is the specifai-mcp-server compatible with all MCP tools?
Yes, it is designed to be tool-agnostic and works with any AI tool supporting the MCP protocol like Hai Build and Cursor.
What kind of Specifai data does this server expose?
It exposes all documents generated by the Specifai project, including requirements and task details.
Is the specifai-mcp-server production-ready?
Currently, it is experimental and subject to changes as development continues.
Can I contribute to the development of specifai-mcp-server?
Yes, the project is open source under the MIT license and contributions are welcome via GitHub.
How does this server improve AI integration with Specifai?
It standardizes access to Specifai project data through MCP, enabling seamless AI tool interoperability.
What programming languages or environments does specifai-mcp-server support?
It is primarily a Node.js server distributed via npm, suitable for JavaScript/TypeScript environments.
Where can I find documentation for configuring the server?
Configuration details are available in the GitHub repository README under the Configuration section.