Skip to main content
Glama

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

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)

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

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

MCP server for asking questions about Cortex Cloud documentation

  1. Features
    1. Installation
      1. Option 1: From PyPI (Recommended)
      2. Installing via Smithery
      3. Option 2: Development Installation
    2. Usage
      1. With Claude Desktop
      2. Manual Testing
    3. Available Tools
      1. Development
        1. Running the server
        2. Installing dependencies
        3. Project structure
      2. License
        1. Contributing
          1. Troubleshooting
            1. Server not starting in Claude Desktop
            2. Missing dependencies
            3. Documentation not found

          Related MCP Servers

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/clarkemn/cortex-cloud-docs-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server