What is Specifai Mcp Server

specifai-mcp-server is a Model Context Protocol (MCP) server designed for integration and automation of the Specifai project with any MCP-compatible AI tools. It allows users to access and manage specification documents generated by the Specifai project.

Use cases

Use cases include retrieving various types of requirement documents, managing user stories, and automating the integration of specifications into development workflows with tools like Hai Build and Cursor.

How to use

To use specifai-mcp-server, install it via npm using the command ‘npx --yes @presidio-dev/specifai-mcp-server@latest’. Configure your project by creating a ‘.specifai-path’ file that points to your project directory. You can then interact with the server using various tools provided.

Key features

Key features include support for multiple tools to access different types of specification documents, such as Business Requirement Documents, Product Requirement Documents, and User Stories. The server is tool agnostic, meaning it can work with any AI tool that supports the MCP protocol.

Where to use

specifai-mcp-server can be used in software development environments where project specifications need to be managed and accessed efficiently, particularly in projects utilizing AI tools for automation.

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 be tool-agnostic, meaning it can be used with any tool that supports the MCP protocol. This server currently exposes tools to read all documents generated by the Specifai project.

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

Table of Contents

• Requirements
• Installation
• Configuration
• Preparing Your Project
• IDE Integration
• Available Tools
• Contributing
• Security
• License

Requirements

• Node.js >= 16.0.0
• Bun >= 1.0.0 (if using Bun runtime)
• Hai Build, Cursor, Windsurf, Claude Desktop or any MCP Client

Installation

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

# Specific version
npx --yes @presidio-dev/[email protected]

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/[email protected]"
    ],
    "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 knows 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 a 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

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": [
        "-y",
        "@presidio-dev/specifai-mcp-server@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": [
        "-y",
        "@presidio-dev/specifai-mcp-server@latest"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": [
        "-y",
        "@presidio-dev/specifai-mcp-server@latest"
      ]
    }
  }
}

{
  "context_servers": {
    "specifai": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@presidio-dev/specifai-mcp-server@latest"
        ]
      }
    }
  }
}

Available Tools

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

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