clarkemn/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

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.