# mcp-my-site

Crawls your website into an index, then serves it to agents as search and fetch tools they can query.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: pournasserian
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pournasserian/mcp-my-site
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-my-site

## What it does

The `mcpmysite` CLI walks the site, splits pages into chunks and writes a hybrid index: BM25 term matching plus vector search over embeddings. A small ASP.NET Core app then exposes that index over MCP with two tools, `search` and `fetch`, and also as a JSON endpoint for a search box on the site itself. Each server handles one site, sized for sites under 1,000 pages.

You can start with no credentials at all. The first build is keyword-only, so no embedding provider is involved. Switching to hybrid later takes one setting and a rebuild. That mode needs a key for an OpenAI-compatible embeddings endpoint — OpenRouter unless you point it elsewhere — and the key is read from `AI_API_KEY` rather than stored in a file. If the provider is unreachable, search falls back to keywords instead of failing.

Everything runs on the .NET 10 SDK. Mount the index into the container or give the server a URL for it, and it polls the source so a fresh build goes live without a restart. There is a live instance indexing pournasserian.com if you want to poke at it before setting up your own.

## Requirements
- Needs: Docker
- Remote server: `https://ai.pournasserian.com/mcp`
- Environment variables: `Index__Path`, `AI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-my-site https://ai.pournasserian.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp-my-site --url https://ai.pournasserian.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-my-site": {
            "url": "https://ai.pournasserian.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-my-site": {
            "type": "http",
            "url": "https://ai.pournasserian.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-my-site https://ai.pournasserian.com/mcp
```

## When to use it
- answer questions from your own site's pages instead of guessing
- give a coding agent search over project docs without a hosted service
- power a site search box from the JSON API
- move from keyword search to semantic search without a rewrite
- publish a rebuilt index while the server keeps running

## Example prompts
- Search the site for the contact page and summarise how to reach the team
- Fetch the page about caching and list its main points
- Look through the index for anything about installation and give me the links

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md