README.md•2.26 kB
# Spec Kit MCP Server
This is a Model Context Protocol (MCP) server for [Spec Kit](https://github.com/github/spec-kit). It allows AI assistants to interact with Spec Kit templates and workflows directly to help manage project specifications, planning, and implementation.
## Prerequisites
Before using this MCP server, you must have `specify-cli` installed on your system.
### Persistent Installation (Recommended)
Install once and use everywhere:
```bash
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
```
Then use the tool directly:
```bash
specify init <PROJECT_NAME>
specify check
```
To upgrade Specify, see the Upgrade Guide for detailed instructions. Quick upgrade:
```bash
uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git
```
## Installation & Usage
### Using with MCP Clients (e.g., Claude Desktop, Cursor)
You can run this server directly using `npx`. Add the following configuration to your MCP client settings:
```json
{
"mcpServers": {
"spec-kit": {
"command": "npx",
"args": [
"-y",
"@anyicode/spec-kit-mcp@latest"
]
}
}
}
```
## Features
This server provides prompts and tools to guide the AI through the Spec Kit workflow:
* **Constitution** (`speckit.constitution`): Establish or review project principles (code quality, testing, etc.).
* **Specify** (`speckit.specify`): Combine templates with user requirements to describe what to build.
* **Plan** (`speckit.plan`): Analyze the project and create a technical plan.
* **Tasks** (`speckit.tasks`): Break down the plan into actionable tasks.
* **Implement** (`speckit.implement`): Provide implementation guidelines.
The server automatically detects and uses the `commands/` directory in your project root to access these templates.
## Publishing
To release a new version of this package, follow these steps:
1. Update the package version (e.g., patch, minor, major):
```bash
npm version patch
```
2. Build the project:
```bash
npm run build
```
3. Publish the package to npm:
```bash
npm publish --access public
```
4. Verify the package is published:
```bash
npm view @anyicode/spec-kit-mcp
```