# MCP Document & Task Server

Example [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers from the Medium article
[The Model Context Protocol (MCP): Fundamentals, Real-World Applications, and Building AI Agent Integrations](https://medium.com/@deepujain/the-model-context-protocol-mcp-fundamentals-real-world-applications-and-building-ai-agent-ba43bdc379f4).

Two self-contained MCP servers that any compatible AI host (Claude Desktop, Cursor, or a custom agent) can discover and use automatically.

## Servers

**`server.py`** -- Document database with three tools:
- `search_documents(query)` -- search documents by title
- `get_document(doc_id)` -- retrieve a document by ID
- `create_document(title, content, author)` -- create a new document

**`task_server.py`** -- Task tracker with two tools:
- `search_tasks(query)` -- search tasks by title keyword
- `get_tasks_by_status(status)` -- get tasks by status (`todo`, `in_progress`, `done`)

## Quick Start

```bash
# Clone the repo
git clone https://github.com/deepujain/mcp-doc-server.git
cd mcp-doc-server

# Create virtual environment and install dependencies
uv venv
source .venv/bin/activate
uv sync
```

### Test with the MCP Inspector

```bash
# Document server
mcp dev server.py

# Task tracker (in a separate terminal)
mcp dev task_server.py
```

The Inspector opens in your browser. Click **Tools > List Tools**, select a tool, fill in the input, and hit **Run Tool**.

### Connect to Cursor

Add to `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "document-db": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-doc-server", "run", "server.py"]
    },
    "task-tracker": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-doc-server", "run", "task_server.py"]
    }
  }
}
```

Replace `/path/to/mcp-doc-server` with the actual path. Restart Cursor, then ask in agent chat:

> "Find the Q1 report and summarize it"

> "What tasks are in progress?"

### Connect to Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "document-db": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-doc-server", "run", "server.py"]
    },
    "task-tracker": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-doc-server", "run", "task_server.py"]
    }
  }
}
```

Restart Claude Desktop. The tools appear automatically.

## Requirements

- Python 3.10+
- [UV](https://docs.astral.sh/uv/) package manager

## License

MIT