Cortex Cloud Docs MCP Server

🚀 Cortex Cloud Docs MCP Server

A Model Context Protocol (MCP) server that offers search access to Cortex Cloud documentation, enabling Claude and other MCP - compatible clients to search through official documentation and API references of Cortex Cloud.

🚀 Quick Start

This MCP server simplifies access to Cortex Cloud's documentation. You can use it directly with Claude Desktop or test it manually.

✨ 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 Examples

Basic 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.

Advanced Usage

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

📚 Documentation

The server provides these MCP tools:

🔧 Technical Details

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

⚠️ Important Note

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

💡 Usage Tip

Run uv sync to ensure all dependencies are installed.

Documentation not found

💡 Usage Tip

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