Cyanheads Mcp Server
by cyanheadscommunityv0.3.2
1
This MCP server provides semantic search over a catalog of 40+ hosted MCP servers and tools, returning ranked matches and brief summaries. It also resolves a tool or server name to its connection URL and per-client install snippets.
From the registry: Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.
Install & configure
Prerequisites
- optionalInstall Node.js or BunInstall Bun v1.3.0+ or Node.js v24+ to run the server locally. The simplest portable path in the README uses npx, which requires Node.js.https://bun.sh/'}],
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `cyanheads-mcp-server` MCP server into my current AI client (that's you).
Optional prerequisites:
- Install Node.js or Bun — Install Bun v1.3.0+ or Node.js v24+ to run the server locally. The simplest portable path in the README uses npx, which requires Node.js. (https://bun.sh/'}],)
Canonical MCP server config (HTTP transport):
- url: `https://cyanheads.caseyjhand.com/mcp`
Note: README offers both a public hosted Streamable HTTP endpoint and local stdio/self-hosted options. Per the portability rule, the simplest local stdio shape would be command `npx`, args `['-y','@cyanheads/cyanheads-mcp-server@latest']`, with optional env vars such as MCP_TRANSPORT_TYPE=stdio and MCP_LOG_LEVEL=info. However, the README explicitly presents the hosted instance as 'no installation required', so the primary canonical config is the public HTTP endpoint. No environment variables are required for the hosted endpoint.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: README offers both a public hosted Streamable HTTP endpoint and local stdio/self-hosted options. Per the portability rule, the simplest local stdio shape would be command `npx`, args `['-y','@cyanheads/cyanheads-mcp-server@latest']`, with optional env vars such as MCP_TRANSPORT_TYPE=stdio and MCP_LOG_LEVEL=info. However, the README explicitly presents the hosted instance as 'no installation required', so the primary canonical config is the public HTTP endpoint. No environment variables are required for the hosted endpoint.
Tools (2)
cyanheads_search
Search fleet tools and servers by natural-language query, returning ranked matches with brief summaries and the owning server.
cyanheads_describe
Return the connection URL and per-client install snippets for a named tool or server.
Environment variables
MCP_TRANSPORT_TYPESelects the transport type, stdio or http.MCP_HTTP_PORTHTTP server port.MCP_HTTP_HOSTHTTP server bind host.MCP_HTTP_ENDPOINT_PATHHTTP endpoint path where the MCP server is mounted.MCP_AUTH_MODEAuthentication mode, such as none, jwt, or oauth.MCP_LOG_LEVELLog level.CATALOG_URLRemote fleet.json endpoint used as the catalog source.CATALOG_FETCH_TIMEOUT_MSTimeout for fetching the catalog JSON.CATALOG_REFRESH_SECONDSBackground poll interval for refreshing the catalog.EMBEDDING_MODEL_IDHugging Face model id used to embed search queries.SIMILARITY_FLOORCosine similarity cutoff for search results.Prerequisites
- • Node.js v24+
Packages
@cyanheads/cyanheads-mcp-server
npmv0.3.2transport: stdio
@cyanheads/cyanheads-mcp-server
npmv0.3.2transport: streamable-http
Remote Endpoints
https://cyanheads.caseyjhand.com/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Jun 5, 2026
- Last commit
- Jun 12, 2026
- Registry name
- io.github.cyanheads/cyanheads-mcp-server