MCP服务器

一个基于Supabase认证和Express传输的MCP服务器,用于快速开发和部署工具服务。

  • by RobertvandeCamp
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 RobertvandeCamp/codaeva-mcp-server-template

使用说明

{{DISPLAY_NAME}}MCP服务器

用于{{DISPLAY_NAME}}的MCP服务器,具有Supabase身份验证和Express传输。

快速开始

  1. 复制环境文件:

    cp .env.example .env
    
  2. 在中填写Supabase凭据 .env:

    • SUPABASE_URL --您的Supabase项目URL
    • SUPABASE_ANON_KEY --Supabase匿名/公钥
  3. 安装并运行:

    npm install
    npm run dev
    
  4. 健康检查:

    GET http://localhost:{{DEV_PORT}}/health
    

身份验证模式

模式 环境 配置
JWT/JWKS 生产 默认--通过Supabase JWKS验证令牌
开发模式 开发 AUTH_DISABLED=true --绕过身份验证,需要 SUPABASE_SERVICE_KEY
自动登录 开发 AUTH_EMAIL + AUTH_PASSWORD --启动时进行身份验证

工具

工具 说明
get_my_info 返回经过身份验证的用户的个人资料(电子邮件、姓名、角色、管理员状态)

项目结构

src/
├── index.ts          # Entry point
├── server.ts         # Express + MCP transport
├── config.ts         # Zod env validation
├── logger.ts         # Pino + AsyncLocalStorage
├── auth/             # JWT, dev mode, auto-login (8 files)
├── lib/              # createToolHandler, response utils
├── tools/            # MCP tools (get-my-info.ts)
├── data-access/      # Supabase client, queries, types
└── resources/        # MCP resources (TOOLS_OVERVIEW.md)

码头工人

为生产而构建(amd64):

docker buildx build --platform linux/amd64 -f docker/Dockerfile -t your-ecr-repo:latest --push .

模板变量

看 TEMPLATE_VARS.md 对于所有 {{VAR}} 占位符。