MCP Server

Active

Apache-2.0

io.github.cyanheads/toolkit-mcp-server MCP Server

Name: io.github.cyanheads/toolkit-mcp-server MCP Server
Author: io.github.cyanheads

io.github.cyanheads/toolkit-mcp-server

Repository Registry

What is the io.github.cyanheads/toolkit-mcp-server MCP server?

Generate IDs, QR codes, and hashes, encode values, geolocate IPs, plus gated host diagnostics.

How to install io.github.cyanheads/toolkit-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
TOOLKIT_ENABLE_NET_DIAGNOSTICS
Register the gated toolkit_check_network tool. Off by default — leave off for hosted/shared deployments.
TOOLKIT_ENABLE_SYSTEM_INFO
Register the gated toolkit_check_system tool. Off by default — only meaningful on a local deployment.
TOOLKIT_ALLOW_PRIVATE_NETWORK
With network diagnostics enabled, permit private/reserved/loopback targets. The second explicit gate; off by default.
TOOLKIT_GEO_PROVIDER
IP-geolocation provider id. Default 'ip-api' is the keyless free tier.
TOOLKIT_GEO_API_KEY
secret
API key for the geolocation provider, if it requires one. The default ip-api tier is keyless.
TOOLKIT_GEO_BASE_URL
Base URL for the geolocation provider. Default is the keyless ip-api endpoint.
TOOLKIT_GEO_CACHE_TTL_SECONDS
Geolocation cache TTL in seconds. Geolocation is stable, so repeats are cached.
TOOLKIT_GEO_RATE_LIMIT_PER_MIN
Max geolocation requests per minute; excess requests are rejected with a retryable rate-limit error. Default 45 matches the ip-api free tier.
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "toolkit-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/toolkit-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<YOUR_TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
        "TOOLKIT_ENABLE_SYSTEM_INFO": "<YOUR_TOOLKIT_ENABLE_SYSTEM_INFO>",
        "TOOLKIT_ALLOW_PRIVATE_NETWORK": "<YOUR_TOOLKIT_ALLOW_PRIVATE_NETWORK>",
        "TOOLKIT_GEO_PROVIDER": "<YOUR_TOOLKIT_GEO_PROVIDER>",
        "TOOLKIT_GEO_API_KEY": "<YOUR_TOOLKIT_GEO_API_KEY>",
        "TOOLKIT_GEO_BASE_URL": "<YOUR_TOOLKIT_GEO_BASE_URL>",
        "TOOLKIT_GEO_CACHE_TTL_SECONDS": "<YOUR_TOOLKIT_GEO_CACHE_TTL_SECONDS>",
        "TOOLKIT_GEO_RATE_LIMIT_PER_MIN": "<YOUR_TOOLKIT_GEO_RATE_LIMIT_PER_MIN>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "toolkit-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/toolkit-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<YOUR_TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
        "TOOLKIT_ENABLE_SYSTEM_INFO": "<YOUR_TOOLKIT_ENABLE_SYSTEM_INFO>",
        "TOOLKIT_ALLOW_PRIVATE_NETWORK": "<YOUR_TOOLKIT_ALLOW_PRIVATE_NETWORK>",
        "TOOLKIT_GEO_PROVIDER": "<YOUR_TOOLKIT_GEO_PROVIDER>",
        "TOOLKIT_GEO_API_KEY": "<YOUR_TOOLKIT_GEO_API_KEY>",
        "TOOLKIT_GEO_BASE_URL": "<YOUR_TOOLKIT_GEO_BASE_URL>",
        "TOOLKIT_GEO_CACHE_TTL_SECONDS": "<YOUR_TOOLKIT_GEO_CACHE_TTL_SECONDS>",
        "TOOLKIT_GEO_RATE_LIMIT_PER_MIN": "<YOUR_TOOLKIT_GEO_RATE_LIMIT_PER_MIN>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "toolkit-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/toolkit-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<YOUR_TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
        "TOOLKIT_ENABLE_SYSTEM_INFO": "<YOUR_TOOLKIT_ENABLE_SYSTEM_INFO>",
        "TOOLKIT_ALLOW_PRIVATE_NETWORK": "<YOUR_TOOLKIT_ALLOW_PRIVATE_NETWORK>",
        "TOOLKIT_GEO_PROVIDER": "<YOUR_TOOLKIT_GEO_PROVIDER>",
        "TOOLKIT_GEO_API_KEY": "<YOUR_TOOLKIT_GEO_API_KEY>",
        "TOOLKIT_GEO_BASE_URL": "<YOUR_TOOLKIT_GEO_BASE_URL>",
        "TOOLKIT_GEO_CACHE_TTL_SECONDS": "<YOUR_TOOLKIT_GEO_CACHE_TTL_SECONDS>",
        "TOOLKIT_GEO_RATE_LIMIT_PER_MIN": "<YOUR_TOOLKIT_GEO_RATE_LIMIT_PER_MIN>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "toolkit-mcp-server": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/toolkit-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<YOUR_TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
        "TOOLKIT_ENABLE_SYSTEM_INFO": "<YOUR_TOOLKIT_ENABLE_SYSTEM_INFO>",
        "TOOLKIT_ALLOW_PRIVATE_NETWORK": "<YOUR_TOOLKIT_ALLOW_PRIVATE_NETWORK>",
        "TOOLKIT_GEO_PROVIDER": "<YOUR_TOOLKIT_GEO_PROVIDER>",
        "TOOLKIT_GEO_API_KEY": "<YOUR_TOOLKIT_GEO_API_KEY>",
        "TOOLKIT_GEO_BASE_URL": "<YOUR_TOOLKIT_GEO_BASE_URL>",
        "TOOLKIT_GEO_CACHE_TTL_SECONDS": "<YOUR_TOOLKIT_GEO_CACHE_TTL_SECONDS>",
        "TOOLKIT_GEO_RATE_LIMIT_PER_MIN": "<YOUR_TOOLKIT_GEO_RATE_LIMIT_PER_MIN>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Claude Code

claude mcp add toolkit-mcp-server --env MCP_LOG_LEVEL=<YOUR_MCP_LOG_LEVEL> --env TOOLKIT_ENABLE_NET_DIAGNOSTICS=<YOUR_TOOLKIT_ENABLE_NET_DIAGNOSTICS> --env TOOLKIT_ENABLE_SYSTEM_INFO=<YOUR_TOOLKIT_ENABLE_SYSTEM_INFO> --env TOOLKIT_ALLOW_PRIVATE_NETWORK=<YOUR_TOOLKIT_ALLOW_PRIVATE_NETWORK> --env TOOLKIT_GEO_PROVIDER=<YOUR_TOOLKIT_GEO_PROVIDER> --env TOOLKIT_GEO_API_KEY=<YOUR_TOOLKIT_GEO_API_KEY> --env TOOLKIT_GEO_BASE_URL=<YOUR_TOOLKIT_GEO_BASE_URL> --env TOOLKIT_GEO_CACHE_TTL_SECONDS=<YOUR_TOOLKIT_GEO_CACHE_TTL_SECONDS> --env TOOLKIT_GEO_RATE_LIMIT_PER_MIN=<YOUR_TOOLKIT_GEO_RATE_LIMIT_PER_MIN> --env MCP_HTTP_HOST=<YOUR_MCP_HTTP_HOST> --env MCP_HTTP_PORT=<YOUR_MCP_HTTP_PORT> --env MCP_HTTP_ENDPOINT_PATH=<YOUR_MCP_HTTP_ENDPOINT_PATH> --env MCP_AUTH_MODE=<YOUR_MCP_AUTH_MODE> -- bun -y @cyanheads/toolkit-mcp-server run start:stdio

Related MCP servers

io.github.cyanheads/obsidian-mcp-server

Active

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP.

611

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/git-mcp-server

Maintained

Comprehensive Git MCP server with 28 tools for clone, commit, branching, merging, and advanced workflows.

226

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-core

Active

Agent-native TypeScript framework for building MCP servers with declarative definitions.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-template

Active

TypeScript template for building MCP servers with declarative tooling, observability, and auth.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/pubmed-mcp-server

Active

Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.

116

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/clinicaltrialsgov-mcp-server

Active

Search ClinicalTrials.gov — find studies, retrieve results, match patients to eligible trials.

TypeScript

Apache-2.0

View repository →