# Semantic Search MCP Server

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/mhart/mcp-semantic-search)

An MCP Server using the [Agents SDK](https://developers.cloudflare.com/agents/guides/remote-mcp-server/) that can search documentation stored
in a [Vectorize](https://developers.cloudflare.com/vectorize/) database.

The same code that powers the MCP Server at https://mcp.developers.cloudflare.com/sse (or https://mcp.developers.cloudflare.com/mcp for the stateless version)

## Using in Claude Desktop

```jsonc
{
  "mcpServers": {
    "cloudflare-docs": {
      "command": "npx", // or may need the full path, eg if using volta: "/Users/myuser/.volta/bin/npx"
      "args": ["mcp-remote@latest", "https://mcp.developers.cloudflare.com/mcp"]
      // Below only needed if you're using a Zero Trust client like Cloudflare WARP
      // "env": {
      //   "NODE_EXTRA_CA_CERTS": "/path/to/certificate.pem"
      // }
    }
  }
}
```

## Testing in Cloudflare's AI Playground

Go to https://playground.ai.cloudflare.com/ and enter https://mcp.developers.cloudflare.com/mcp as the MCP Server

## Testing in VSCode

Type Shift-Cmd-P and choose "MCP: Add Server..." and then choose "HTTP (server-sent events)", then enter https://mcp.developers.cloudflare.com/sse as the URL.

## Testing locally (requires a populated Vectorize DB)

```sh
npm run dev
```

Then go to https://playground.ai.cloudflare.com/ and enter http://localhost:8787/mcp as the MCP Server