speclib-mcp
MCP server for searching and retrieving SpecLib specs. Allows AI agents to discover and read specifications via the Model Context Protocol.
Tools
| Tool | Description |
|---|---|
search_specs | Search specs by query, scope, and/or content type |
get_spec | Get full spec content by ID or scope/slug |
list_scopes | List all available scopes |
get_recipe | Get a recipe with its bundled specs |
Resources
| URI | Description |
|---|---|
spec://{scope}/{slug} | Read a spec as markdown |
Usage
One-liner
npx github:rang501/speclib-mcp
Claude Code
Add to your MCP settings (.mcp.json or project config):
{
"mcpServers": {
"speclib": {
"command": "npx",
"args": ["-y", "github:rang501/speclib-mcp"],
"env": {
"SPECLIB_API_URL": "http://localhost:3000"
}
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"speclib": {
"command": "npx",
"args": ["-y", "github:rang501/speclib-mcp"],
"env": {
"SPECLIB_API_URL": "http://localhost:3000"
}
}
}
}
Local development
git clone https://github.com/rang501/speclib-mcp.git
cd speclib-mcp
npm install
node index.mjs
Configuration
| Environment Variable | Default | Description |
|---|---|---|
SPECLIB_API_URL | http://localhost:3000 | SpecLib instance URL |
Requirements
- Node.js >= 20
- A running SpecLib instance (public specs are accessible without authentication)