Metadata-Version: 2.4
Name: pluck-mcp
Version: 0.1.0
Summary: MCP server for Pluck — query your knowledge graph from Claude Desktop, Cursor, and other MCP clients
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# Pluck MCP Server

Connect your Pluck knowledge graph to Claude Desktop, Cursor, and other MCP-compatible AI tools.

## Install

```bash
pip install pluck-mcp
```

Or install from source:

```bash
cd mcp-server
pip install -e .
```

## Configuration

Set these environment variables:

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `PLUCK_INTEGRATION_API_KEY` | Yes | — | API key from Settings > Integrations in Pluck |
| `PLUCK_INTEGRATION_BASE_URL` | No | `http://localhost:8100` | Base URL of your Pluck instance |

## Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_...",
        "PLUCK_INTEGRATION_BASE_URL": "https://www.pluckagent.com"
      }
    }
  }
}
```

## Cursor

Add to your Cursor MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_...",
        "PLUCK_INTEGRATION_BASE_URL": "https://www.pluckagent.com"
      }
    }
  }
}
```

## Claude Code

Add to your Claude Code MCP settings (`.claude/settings.json`):

```json
{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_...",
        "PLUCK_INTEGRATION_BASE_URL": "https://www.pluckagent.com"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `ask_pluck` | Ask a question and get a researched answer with knowledge graph context |
| `list_document_types` | List all document types discovered in the knowledge graph |
| `get_schema_fields` | Get schema fields for a specific document type |
| `vector_search` | Semantic search across documents and chunks |
| `query_documents` | Query documents with filtering and sorting |
| `get_entity_neighbors` | Explore entity relationships in the knowledge graph |
| `get_full_text` | Retrieve full text of a document or chunk |

## Development

```bash
cd mcp-server
pip install -e .
PLUCK_INTEGRATION_API_KEY=plk_live_... pluck-mcp
```
