README.md•4.3 kB
# Cortex Cloud Docs MCP Server
[](https://smithery.ai/server/@clarkemn/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.
<a href="https://glama.ai/mcp/servers/@clarkemn/cortex-cloud-docs-mcp-server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@clarkemn/cortex-cloud-docs-mcp-server/badge" alt="cortex-cloud-docs-mcp-server MCP server" />
</a>
## 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](https://smithery.ai/server/@clarkemn/cortex-cloud-docs-mcp-server):
```bash
npx -y @smithery/cli install @clarkemn/cortex-cloud-docs-mcp-server --client claude
```
### Option 2: Development Installation
#### Prerequisites
- Python 3.12 or higher
- [uv](https://docs.astral.sh/uv/) package manager
#### Install uv
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
#### Clone and Setup
```bash
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)
```json
{
"mcpServers": {
"Cortex Cloud Docs": {
"command": "uvx",
"args": ["cortex-cloud-docs-mcp-server@latest"],
"env": {},
"transport": "stdio"
}
}
}
```
#### Option 2: Local Development
```json
{
"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:
```bash
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
```bash
uv run python server.py
```
### Installing dependencies
```bash
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.