Metadata-Version: 2.4
Name: adminica-mcp
Version: 1.0.1
Summary: MCP server for Adminica — library search and RAG chat in Cursor, Claude Desktop, VS Code
Author-email: Adminica Team <info@adminica.ru>
License-Expression: MIT
Project-URL: Homepage, https://adminica.ru
Project-URL: Documentation, https://adminica.ru/api/docs/#mcp
Project-URL: Repository, https://gitlab.main.tx0.ru/lebedev/adminica-assistant
Project-URL: Bug Tracker, https://gitlab.main.tx0.ru/lebedev/adminica-assistant/-/issues
Keywords: mcp,adminica,rag,cursor,claude,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.6.0
Requires-Dist: httpx>=0.25.2

# adminica-mcp

[![PyPI](https://img.shields.io/pypi/v/adminica-mcp.svg)](https://pypi.org/project/adminica-mcp/)

[MCP](https://modelcontextprotocol.io) server for [Adminica](https://adminica.ru) — search the knowledge archive and ask RAG-grounded questions from Cursor, Claude Desktop, VS Code, and other MCP clients.

No git clone required — install from PyPI:

```bash
pip install adminica-mcp
which adminica-mcp   # use this path in MCP config if the IDE does not find the command
```

## Tools

| Tool | Description |
|------|-------------|
| `search_library` | Vector search in the Adminica archive |
| `ask_adminica` | Full RAG answer (`POST /api/v1/query`, requires API key) |
| `get_library_entry` | Library entry card by UUID |
| `adminica_health` | Check Adminica `/health` |

## Environment

| Variable | Required | Default |
|----------|----------|---------|
| `ADMINICA_API_KEY` | for `ask_adminica` | — |
| `ADMINICA_API_URL` | no | `https://adminica.ru/api/v1` |

Create an API key at [adminica.ru/profile](https://adminica.ru/profile/) → Security.

## MCP client config

```json
{
  "mcpServers": {
    "adminica": {
      "command": "adminica-mcp",
      "env": {
        "ADMINICA_API_KEY": "ak_YOUR_KEY"
      }
    }
  }
}
```

Full guide: [adminica.ru/api/docs/#mcp](https://adminica.ru/api/docs/#mcp)

## License

MIT
