MCP协议服务器

一个基于AWS Lambda部署的简单MCP(Model Context Protocol)服务器,支持本地开发和云端部署,适用于模型交互场景。

  • by mfang0126
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mfang0126/ts-mcp-fargate-ecs-starter

使用说明

你好,MCP服务器

一个简单的MCP(模型上下文协议)服务器,支持AWS Lambda部署。

🚀 快速入门

本地开发

npm install
npm run dev

通过在配置中添加来连接到Claude Desktop:

{
  "mcpServers": {
    "hello-mcp": {
      "command": "npx",
      "args": ["tsx", "/Users/mingfang/Code/hello-mcp/index.ts"]
    }
  }
}

部署到 AWS Lambda

# Build and deploy
npm run deploy

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

首次设置:

  • 堆栈名称: hello-mcp-stack
  • 地区: ap-southeast-2
  • 承载令牌(Bearer Token): mcp-secret-token-12345
  • 确认全部: Y

🔑 认证

不记名令牌(Bearer token): mcp-secret-token-12345

修改它:

sam deploy --parameter-overrides BearerToken="your-new-token"

🧪 测试部署

# 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

🔌 将Claude连接到Lambda

编辑: ~/Library/Application Support/Claude/claude_desktop_config.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"
      }
    }
  }
}

重要提示: 使用 "transport": "http" 对于Lambda。

🛠️ 工具

  • 说你好 - 以名字打招呼

📋 部署记录

堆栈名称: hello-mcp-stack 地区: ap-southeast-2 已部署: 2025年10月17日 状态: ✅ 已测试并正常工作

输出:

  • API URL: https://gjt4ggcz76.execute-api.ap-southeast-2.amazonaws.com/
  • Lambda ARN: arn:aws:lambda:ap-southeast-2:670326884047:function:hello-mcp-server
  • 认证: 使用“http”传输的承载令牌

测试结果:

# ✅ Health check working
# ✅ Tool listing: ["sayHello"]
# ✅ sayHello execution: "Hello, AWS Lambda! 👋"

📁 项目结构

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

💰 费用

Lambda 免费套餐:每月100万次请求 预计费用:0-5美元/月

📚 了解更多