# Quick Install Guide - pdf-mcp-server

## 🎯 Installation (Choose One)

### Option 1: npm (Recommended for Users)
```bash
npm install pdf-mcp-server
```

### Option 2: npx (For Quick Testing)
```bash
npx pdf-mcp-server
```

### Option 3: From Source (For Development)
```bash
git clone https://github.com/ramyalakhani2108/pdf-mcp.git
cd pdf-mcp
npm install
npm run build
npm start
```

---

## 🖥️ Configure for Claude Desktop

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "pdf-operations": {
      "command": "node",
      "args": ["-m", "pdf-mcp-server"]
    }
  }
}
```

---

## 🔗 Configure for VS Code Copilot

Add to `.vscode/settings.json`:

```json
{
  "github.copilot.mcp.servers": {
    "pdf-operations": {
      "command": "node",
      "args": ["-m", "pdf-mcp-server"]
    }
  }
}
```

---

## 📦 Available Tools

| Tool | Description |
|------|-------------|
| `count-pdf-pages` | Count total pages in a PDF |
| `extract-pdf-text` | Extract all text content |
| `extract-pdf-metadata` | Get metadata (title, author, dates) |
| `summarize-pdf` | AI-powered summarization |
| `answer-pdf-question` | Answer questions about PDFs |
| `analyze-pdf-page` | Advanced page analysis |
| `detect-text-position` | Precise text position detection |
| `add-watermark` | Add watermarks with pixel-perfect centering |
| `add-header-footer` | Add headers/footers to PDFs |

---

## 🚀 Quick Test

```bash
# Start the server
npx pdf-mcp-server

# In another terminal, test with curl (if MCP server exposes HTTP)
# Or use with Claude Desktop / VS Code Copilot
```

---

## 📚 Documentation

- **README**: https://github.com/ramyalakhani2108/pdf-mcp
- **npm Package**: https://www.npmjs.com/package/pdf-mcp-server
- **Full Guide**: See PUBLISHING_SUMMARY.md

---

## ✅ Requirements

- **Node.js**: >=18.0.0
- **npm**: >=8.0.0
- **MCP Client**: Claude Desktop or VS Code Copilot

---

**That's it! Your MCP server is ready to use. 🎉**