# Claude MCP Server
### Connect Manus → Claude (Anthropic API) via MCP

This server exposes Claude as 3 MCP tools that Manus can call:
- **ask_claude** — General prompt → response
- **claude_analyze** — Structured analysis (summarize, critique, extract, etc.)
- **claude_write** — Content generation (email, report, social post, etc.)

---

## Quick Start (Local)

```bash
# 1. Install dependencies
npm install

# 2. Set your API key
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY

# 3. Run in dev mode
npm run dev

# Server runs at http://localhost:3000
# MCP endpoint: http://localhost:3000/mcp
```

---

## Deploy to Railway (FREE — Recommended)

Railway gives you a free hosted URL — perfect for Manus to connect to.

### Steps:

1. **Push to GitHub**
```bash
git init
git add .
git commit -m "initial commit"
gh repo create claude-mcp-server --public --push
# or use github.com to create repo manually
```

2. **Deploy on Railway**
- Go to [railway.app](https://railway.app)
- Click **New Project → Deploy from GitHub Repo**
- Select your repo
- Click **Variables** → Add:
  - `ANTHROPIC_API_KEY` = your key from console.anthropic.com
  - `PORT` = 3000
- Railway auto-builds and gives you a URL like:
  `https://claude-mcp-server-production.up.railway.app`

3. **Your MCP endpoint will be:**
```
https://claude-mcp-server-production.up.railway.app/mcp
```

---

## Deploy to Render (FREE tier available)

1. Go to [render.com](https://render.com)
2. Click **New → Web Service**
3. Connect your GitHub repo
4. Set:
   - **Build Command**: `npm install && npm run build`
   - **Start Command**: `npm start`
   - **Environment Variables**: `ANTHROPIC_API_KEY=your-key`
5. Deploy — you get a URL like `https://claude-mcp-server.onrender.com`

> ⚠️ Render free tier spins down after 15 mins of inactivity (cold start ~30s).
> Railway free tier stays live — better for Manus.

---

## Deploy to Fly.io (FREE hobby tier)

```bash
# Install flyctl
curl -L https://fly.io/install.sh | sh

# Login
fly auth login

# Launch
fly launch

# Set secret
fly secrets set ANTHROPIC_API_KEY=sk-ant-your-key-here

# Deploy
fly deploy
```

---

## Connect to Manus

1. In Manus go to **Settings → Integrations → Custom MCP Servers**
2. Click **Add Server**
3. Paste your URL:
   ```
   https://your-app.up.railway.app/mcp
   ```
4. Save — Manus will now show 3 Claude tools available

### Example Manus prompts once connected:
- *"Use ask_claude to write a professional bio for me"*
- *"Use claude_analyze to summarize this document [paste text]"*
- *"Use claude_write to draft a LinkedIn post about X in a casual tone"*

---

## Tools Reference

### `ask_claude`
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| prompt | string | ✅ | The question or task for Claude |
| system | string | ❌ | Optional system prompt / persona |
| max_tokens | number | ❌ | Max response length (default: 1024) |

### `claude_analyze`
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| content | string | ✅ | Text to analyze |
| focus | enum | ✅ | summarize / critique / compare / extract_key_points / classify |
| instructions | string | ❌ | Extra instructions |

### `claude_write`
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| task | string | ✅ | What to write |
| format | enum | ✅ | email / report / social_post / bullet_list / paragraph / code |
| tone | enum | ❌ | professional / casual / persuasive / empathetic / technical |
| context | string | ❌ | Background context |

---

## Health Check

```bash
curl https://your-app.up.railway.app/health
# → {"status":"ok","server":"claude-mcp-server"}
```

---

## Cost

- **Hosting**: Free on Railway (500 hrs/month free) or Render
- **API**: Anthropic charges per token used — Claude Sonnet is ~$3/million input tokens
  - A typical ask_claude call costs < $0.01