Metadata-Version: 2.5
Name: andish-mcp
Version: 0.2.0
Summary: MCP server for the Andish Knowledge Graph API
Project-URL: Homepage, https://andish.ru
Project-URL: Documentation, https://andish.ru/docs
Author: Andish Team
License: MIT
License-File: LICENSE
Keywords: andish,knowledge-graph,llm,mcp,rag
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28
Requires-Dist: mcp<2,>=1.28.1
Requires-Dist: pydantic>=2.9
Requires-Dist: structlog>=25.1
Requires-Dist: tenacity>=9.1.4
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: hatchling>=1.27; extra == 'dev'
Requires-Dist: mypy>=1.14.0; extra == 'dev'
Requires-Dist: packaging>=24.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.9.0; extra == 'dev'
Description-Content-Type: text/markdown

# andish-mcp

MCP server for the [Andish](https://andish.ru) Knowledge Graph API.

Works with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Cline, Continue, and others.

> Registry ownership verification:
> mcp-name: ru.andish/andish-mcp

## Install

```bash
uvx andish-mcp@latest
```

Or with pip:

```bash
pip install andish-mcp
```

## Configure (Claude Desktop)

```jsonc
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "andish": {
      "command": "uvx",
      "args": ["andish-mcp@latest"],
      "env": {
        "ANDISH_API_KEY": "adsh_live_xxxxxxxxxxxx"
      }
    }
  }
}
```

## Available Tools

Nine tools are registered by the server.

| Tool | What it does |
|---|---|
| `andish_query` | Search the workspace knowledge graph and synthesise an answer. |
| `andish_context` | Fetch raw context from the knowledge graph and write the answer yourself. |
| `andish_list_documents` | List documents uploaded to the workspace. |
| `andish_get_document` | Fetch metadata and a content excerpt for one document. |
| `andish_upload_document` | Upload a local file to the workspace for indexing. |
| `andish_search_entities` | Search entities (people, organizations, concepts) by label substring. |
| `andish_get_neighbors` | Return entities connected to an entity, directly (hop=1) or transitively (hop=2). |
| `andish_workspace_usage` | Show current workspace usage: documents, cost, daily queries. |
| `andish_health` | Check server health and API connectivity. |

## Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `ANDISH_API_KEY` | Yes | — | API key from https://andish.ru/dashboard |
| `ANDISH_BASE_URL` | No | `https://api.andish.ru/v1` | Override for self-hosted or staging |
| `ANDISH_TIMEOUT` | No | `30.0` | Per-request timeout in seconds |
