← Index

io.github.intent-driven-software/idf-mcp

io.github.intent-driven-software/idf-mcp·v1.0.2·Cloud Storage
Quality Score
85
/100

Turn an IDF domain into an MCP server with invariants and role scopes in every tool description.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<idf_server>",
        "IDF_DOMAIN": "<idf_domain>",
        "IDF_BOOTSTRAP": "<idf_bootstrap>",
        "IDF_ONTOLOGY_PATH": "<idf_ontology_path>",
        "IDF_AUTH_TOKEN": "<your-idf_auth_token>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "idf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@intent-driven/mcp-server"
      ],
      "env": {
        "IDF_SERVER": "<idf_server>",
        "IDF_DOMAIN": "<idf_domain>",
        "IDF_BOOTSTRAP": "<idf_bootstrap>",
        "IDF_ONTOLOGY_PATH": "<idf_ontology_path>",
        "IDF_AUTH_TOKEN": "<your-idf_auth_token>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @intent-driven/mcp-server
§02  Environment variables
IDF_SERVER
required

Base URL of the IDF host runtime (e.g. http://localhost:3001).

IDF_DOMAIN
required

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
secret

Optional bearer token forwarded to the host runtime as the agent's role credential.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Cloud Storage