Intent Driven MCP Server
by intent-driven-softwareio.github.intent-driven-software/idf-mcpv1.0.2
Turn an IDF domain into an MCP server with invariants and role scopes in every tool description.
context tax
queued
security
queued
cold start
queued
freshness
Slowing5mo ago
Install Intent Driven MCP server
Install in Claude Code
claude mcp add intent-driven -e IDF_SERVER='<idf-server>' -e IDF_DOMAIN='<idf-domain>' -e IDF_AUTH_TOKEN='<idf-auth-token>' -- npx -y @intent-driven/mcp-serverInstall in Cursor
{
"mcpServers": {
"intent-driven": {
"command": "npx",
"args": [
"-y",
"@intent-driven/mcp-server"
],
"env": {
"IDF_SERVER": "<idf-server>",
"IDF_DOMAIN": "<idf-domain>",
"IDF_AUTH_TOKEN": "<idf-auth-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"intent-driven": {
"command": "npx",
"args": [
"-y",
"@intent-driven/mcp-server"
],
"env": {
"IDF_SERVER": "<idf-server>",
"IDF_DOMAIN": "<idf-domain>",
"IDF_AUTH_TOKEN": "<idf-auth-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"intent-driven": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@intent-driven/mcp-server"
],
"env": {
"IDF_SERVER": "<idf-server>",
"IDF_DOMAIN": "<idf-domain>",
"IDF_AUTH_TOKEN": "<idf-auth-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"intent-driven": {
"command": "npx",
"args": [
"-y",
"@intent-driven/mcp-server"
],
"env": {
"IDF_SERVER": "<idf-server>",
"IDF_DOMAIN": "<idf-domain>",
"IDF_AUTH_TOKEN": "<idf-auth-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| IDF_SERVER | yes | — | Base URL of the IDF host runtime (e.g. http://localhost:3001). |
| IDF_DOMAIN | yes | — | IDF domain to expose as MCP tools (e.g. invest, booking, planning). |
| IDF_BOOTSTRAP | — | — | Set to 0 if the host runtime already bootstrapped the domain; 1 (default) to bootstrap from IDF_ONTOLOGY_PATH on first connection. |
| IDF_ONTOLOGY_PATH | — | — | Filesystem path to the domain ontology module (only used when IDF_BOOTSTRAP=1). |
| IDF_AUTH_TOKEN | — | yes | Optional bearer token forwarded to the host runtime as the agent's role credential. |
Freshness
Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-05-10 · 5mo ago · GitHub
Latest release
2026-05-09 · 5mo ago · GitHub · v1.0.4
Package published
no data · npm/PyPI
Registry entry updated
2026-05-06 · 5mo ago · official registry · v1.0.2
FAQ
›How do I install the Intent Driven MCP server in Claude Code?
Run: claude mcp add intent-driven -e IDF_SERVER='<idf-server>' -e IDF_DOMAIN='<idf-domain>' -e IDF_AUTH_TOKEN='<idf-auth-token>' -- npx -y @intent-driven/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Intent Driven require an API key?
Yes. It expects IDF_SERVER, IDF_DOMAIN, IDF_AUTH_TOKEN, of which 1 is a secret.
›Can I use Intent Driven as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Intent Driven in the official MCP registry?
Yes, as io.github.intent-driven-software/idf-mcp.