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.

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:

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

Option 2: Development Installation

Prerequisites

• Python 3.12 or higher
• uv package manager

Install uv

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

Clone and Setup

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)

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

Option 2: Local Development

{
  "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:

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

uv run python server.py

Installing dependencies

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.