cortex-cloud-docs-mcp-server

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

Fork the repository
Create a feature branch
Make your changes
Test with Claude Desktop
Submit a pull request

Troubleshooting

Server not starting in Claude Desktop

Ensure uv is installed and in your PATH
Verify the path to the project directory is correct
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.

cortex-cloud-docs-mcp-server