Installation

Get started with the Speck-It MCP Server in a few simple steps.

Prerequisites

Make sure you have the following installed:

Python 3.10+
uv
Git

Clone the Repository

Get the source code from GitHub:

git clone https://github.com/wuxnz/speck-it-mcp-server.git

Install Dependencies

Install the required dependencies:

uv add --requirements requirements.txt

Run the Development Server

Start the development server to test if it works:

uv dev

Alternative commands:

uv run:

uv run mcp run <path-to-repo>/main.py

Configure MCP Client

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "speck-it": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<path-to-repo>/main.py" // Replace with the actual path
      ],
    }
  }
}

Next Steps

Explore the Documentation

Learn about all the features and capabilities of the Speck-It MCP Server.

API Reference

Try an Example

See the server in action with our comprehensive examples.

View Examples

Troubleshooting

Common Issues

Old Python version

Make sure you're using Python 3.10 or higher.

python --version

MCP server not connecting

Ensure the path to main.py in your MCP configuration is correct and the server is running.