Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@speclib-mcpsearch for specifications about OAuth2 authentication"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
speclib-mcp
MCP server for searching, retrieving, and creating SpecLib specs. Allows AI agents to discover, read, and write specifications via the Model Context Protocol.
Tools
Tool | Description |
| Search specs by query, scope, and/or content type |
| Get full spec content by ID or scope/slug |
| List all available scopes |
| Get a recipe with its bundled specs |
| Create a new spec (requires API token) |
| Update an existing spec (requires API token) |
Resources
URI | Description |
| Read a spec as markdown |
Usage
One-liner
npx github:rang501/speclib-mcpClaude 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",
"SPECLIB_API_TOKEN": "your-api-token"
}
}
}
}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",
"SPECLIB_API_TOKEN": "your-api-token"
}
}
}
}Local development
git clone https://github.com/rang501/speclib-mcp.git
cd speclib-mcp
npm install
node index.mjsConfiguration
Environment Variable | Default | Description |
|
| SpecLib instance URL |
| (none) | API token for write operations (generate in Account > API Tokens) |
Authentication
Reading public specs works without authentication. To create or update specs, you need an API token:
Log in to your SpecLib instance
Go to Account > API Tokens
Create a new token and copy it
Set it as
SPECLIB_API_TOKENin your MCP client config
Tokens that have not been used for over a year are automatically expired.
Requirements
Node.js >= 20
A running SpecLib instance
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.