# Cortex Cloud Docs MCP Server

[![smithery badge](https://smithery.ai/badge/@clarkemn/cortex-cloud-docs-mcp-server)](https://smithery.ai/server/@clarkemn/cortex-cloud-docs-mcp-server)

A Model Context Protocol (MCP) server that provides search access to Cortex Cloud documentation. This server allows Claude and other MCP-compatible clients to search through Cortex Cloud's official documentation and API references.

<a href="https://glama.ai/mcp/servers/@clarkemn/cortex-cloud-docs-mcp-server">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@clarkemn/cortex-cloud-docs-mcp-server/badge" alt="cortex-cloud-docs-mcp-server MCP server" />
</a>

## Features

- Search across Cortex Cloud documentation
- Search Cortex Cloud API documentation  
- Caching system for improved performance
- Real-time indexing of documentation sites

## Installation

### Option 1: From PyPI (Recommended)

No installation needed! Just use `uvx` in your Claude Desktop configuration.

### Installing via Smithery

To install cortex-cloud-docs-mcp-server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@clarkemn/cortex-cloud-docs-mcp-server):

```bash
npx -y @smithery/cli install @clarkemn/cortex-cloud-docs-mcp-server --client claude
```

### Option 2: Development Installation

#### Prerequisites

- Python 3.12 or higher
- [uv](https://docs.astral.sh/uv/) package manager

#### Install uv

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

#### Clone and Setup

```bash
git clone https://github.com/clarkemn/cortex-cloud-docs-mcp-server.git
cd cortex-cloud-docs-mcp-server
uv sync
```

## Usage

### With Claude Desktop

Add this server to your Claude Desktop configuration file:

**Location:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)

#### Option 1: Direct from PyPI (Recommended)

```json
{
  "mcpServers": {
    "Cortex Cloud Docs": {
      "command": "uvx",
      "args": ["cortex-cloud-docs-mcp-server@latest"],
      "env": {},
      "transport": "stdio"
    }
  }
}
```

#### Option 2: Local Development

```json
{
  "mcpServers": {
    "Cortex Cloud Docs": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/cortex-cloud-docs-mcp-server",
      "env": {},
      "transport": "stdio"
    }
  }
}
```

Replace `/path/to/cortex-cloud-docs-mcp-server` with the actual path to where you cloned this repository.

### Manual Testing

You can test the server manually:

```bash
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | uv run python server.py
```

## Available Tools

The server provides these MCP tools:

- `index_cortex_docs(max_pages: int = 50)` - Index Cortex Cloud documentation (call this first)
- `index_cortex_api_docs(max_pages: int = 50)` - Index Cortex Cloud API documentation  
- `search_cortex_docs(query: str)` - Search Cortex Cloud documentation
- `search_cortex_api_docs(query: str)` - Search Cortex Cloud API documentation
- `search_all_docs(query: str)` - Search across all indexed documentation
- `get_index_status()` - Check indexing status and cache statistics

## Development

### Running the server

```bash
uv run python server.py
```

### Installing dependencies

```bash
uv sync
```

### Project structure

```
cortex-cloud-docs-mcp-server/
├── server.py              # Main MCP server implementation
├── pyproject.toml         # Project configuration
├── uv.lock               # Dependency lock file
└── README.md             # This file
```

## License

MIT License - see LICENSE file for details.

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with Claude Desktop
5. Submit a pull request

## Troubleshooting

### Server not starting in Claude Desktop

1. Ensure `uv` is installed and in your PATH
2. Verify the path to the project directory is correct
3. Check Claude Desktop logs for specific error messages

### Missing dependencies

Run `uv sync` to ensure all dependencies are installed.

### Documentation not found

The server needs to index documentation first. Use the `index_cortex_docs` or `index_cortex_api_docs` tools before searching.