# Hello MCP Server

Simple MCP (Model Context Protocol) server with AWS Lambda deployment.

## 🚀 Quick Start

### Local Development
```bash
npm install
npm run dev
```

Connect to Claude Desktop by adding to config:
```json
{
  "mcpServers": {
    "hello-mcp": {
      "command": "npx",
      "args": ["tsx", "/Users/mingfang/Code/hello-mcp/index.ts"]
    }
  }
}
```

### Deploy to AWS Lambda
```bash
# Build and deploy
npm run deploy

# Or step by step
npm run build:lambda
sam deploy --guided
```

**First time setup:**
- Stack Name: `hello-mcp-stack`
- Region: `ap-southeast-2`
- Bearer Token: `mcp-secret-token-12345`
- Confirm all: `Y`

## 🔑 Authentication

Bearer token: `mcp-secret-token-12345`

Change it:
```bash
sam deploy --parameter-overrides BearerToken="your-new-token"
```

## 🧪 Test Deployment

```bash
# Health check
curl https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/health

# List available tools
curl -H "Authorization: Bearer mcp-secret-token-12345" \
  https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/mcp

# Call sayHello tool
curl -X POST \
  -H "Authorization: Bearer mcp-secret-token-12345" \
  -H "Content-Type: application/json" \
  -d '{"tool": "sayHello", "params": {"name": "World"}}' \
  https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/mcp
```

## 🔌 Connect Claude to Lambda

Edit: `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "hello-mcp-lambda": {
      "url": "https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer mcp-secret-token-12345"
      }
    }
  }
}
```

**Important:** Use `"transport": "http"` for Lambda.

## 🛠️ Tools

- **sayHello** - Greet someone by name

## 📋 Deployment Record

**Stack Name:** `hello-mcp-stack`
**Region:** `ap-southeast-2`
**Deployed:** 2025-10-17
**Status:** ✅ Tested and working

**Outputs:**
- **API URL:** `https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/`
- **Lambda ARN:** `arn:aws:lambda:ap-southeast-2:670326884047:function:hello-mcp-server`
- **Authentication:** Bearer token with 'http' transport

**Test Results:**
```bash
# ✅ Health check working
# ✅ Tool listing: ["sayHello"]
# ✅ sayHello execution: "Hello, AWS Lambda! 👋"
```

## 📁 Project Structure

```
hello-mcp/
├── index.ts          # Local development (stdio)
├── lambda.ts         # AWS Lambda handler
├── template.yaml     # AWS SAM template
├── samconfig.toml    # SAM configuration
├── package.json      # Dependencies
└── tsconfig.json     # TypeScript config
```

## 💰 Cost

Lambda free tier: 1M requests/month
Expected cost: $0-5/month

## 📚 Learn More

- [FastMCP](https://github.com/punkpeye/fastmcp)
- [MCP Protocol](https://modelcontextprotocol.io/)
- [AWS Lambda](https://docs.aws.amazon.com/lambda/)