MCP Edge Functions Examples

MCP数据服务

提供方 Rodriguespn

数据服务 未标注 Token 社区 / 第三方

使用Supabase边缘函数实现Model Context Protocol (MCP)服务器的综合示例集合,展示多种MCP模式和框架。

一句话选型结论

按资料字段整理

MCP Edge Functions Examples 属于数据服务类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

边缘计算TypeScript本地部署MCP协议Supabase服务器实现函数计算

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Edge Functions Examples当前 未标注 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Rodriguespn上游标注的维护方 Rodriguespn
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.9 KB
来自项目仓库与上游目录的原文,未做删改

MCP边缘功能示例

使用Supabase边缘函数的模型上下文协议(MCP)服务器实现的全面集合。这些示例演示了在Supabase上构建MCP服务器的各种MCP模式和框架。

概述

此存储库包含作为Supabase边缘功能部署的MCP服务器的实际示例。每个功能都展示了不同的MCP框架和实现模式,从基本的Hono服务器到具有身份验证的全功能MCP实现。

例子

1.Hello World(hello-world)

  • 目的:基础Supabase边缘函数模板
  • 特性:使用JSON的简单HTTP响应
  • 框架:香草Deno
  • 用例:任何边缘函数的起点

你好,Hono(hello-hono)

  • 目的:演示Hono框架集成
  • 特性:带路由的轻量级web框架
  • 框架: 荣誉
  • 用例:在边缘函数上构建REST API

你好,Hono MCP(hello-hono-mcp)

  • 目的:使用Hono和官方MCP SDK的MCP服务器
  • 特性:使用Streamable HTTP传输实现添加工具
  • 框架: 荣誉 + @模型上下文协议/sdk
  • 用例:支持HTTP流媒体的完整MCP服务器

4.你好MCP处理程序(hello-mcp-handler)

  • 目的:使用MCP处理程序简化MCP实现
  • 特性:带模式验证的骰子滚动工具
  • 框架: mcp处理器
  • 用例:使用最少的样板快速设置MCP服务器

5.你好,MCP Lite(hello-mcp-lite)

  • 目的:使用MCP-lite的轻量级MCP服务器
  • 特性:多种工具(计算器、问候语生成器)
  • 框架: mcp-lite
  • 用例:具有Zod验证的简单MCP服务器

6.服务器(server)

  • 目的:具有身份验证和数据库的全功能MCP服务器
  • 特性:
  • 通过Supabase进行JWT身份验证
  • 从数据库动态加载工具
  • 使用OpenAI的人工智能模拟响应
  • 用户特定的服务器配置
  • 框架:mcp处理程序+Supabase+OpenAI
  • 用例:生产就绪的经过身份验证的MCP服务器

7.验证JWT(verify-jwt)

  • 目的:使用Supabase的身份验证示例
  • 特性:JWT验证、用户数据检索、数据库查询
  • 框架:Supabase客户端
  • 用例:通过身份验证保护边缘功能

8.你好,X402 MCP(hello-x402-mcp)

  • 目的:MCP服务器,用于支付工具的区块链支付协议
  • 特性:
  • x402支付协议集成
  • 自动402付款要求处理
  • EIP-3009支付授权
  • 美元兑加元对Base Sepolia的小额支付
  • 钱包管理和余额检查
  • 框架: x402 +Hono+@modelcontextprotocol/sdk
  • 用例:通过区块链支付、支付API访问使MCP工具货币化

MCP框架比较

框架 复杂性 功能 最适合
Vanilla Deno 低 基本HTTP 简单功能
Hono 低 路由、中间件 REST API
mcp-lite 中等 工具、资源、提示 轻量级mcp服务器
mcp处理程序 中等 简化mcp设置 快速原型制作
@modelcontextprotocol/sdk 高 完整的MCP规范,流式传输 生产MCP服务器
x402+MCP 高 付费工具,区块链支付 货币化MCP服务

入门指南

先决条件

  • Supabase命令行界面 安装
  • Supabase项目(本地或远程)
  • Deno运行时(附带Supabase CLI)
  • Node.js 18+(用于包管理)

地方发展

  1. 克隆此存储库:```bash
    cd mcp-edge-functions-examples

1. **在本地启动Supabase**:```bash
supabase start
  1. 在本地执行特定功能:```bash

Basic function

supabase functions serve hello-world

MCP server with Hono

supabase functions serve hello-hono-mcp

Full authenticated server

supabase functions serve server


1. **测试功能**:```bash
# Basic hello-world
curl -i --location --request POST 'http://localhost:54321/functions/v1/hello-world' \
--header 'Authorization: Bearer YOUR_ANON_KEY' \
--header 'Content-Type: application/json'

# Hono-based MCP server (note the /mcp endpoint)
curl -X POST 'http://localhost:54321/functions/v1/hello-hono-mcp/mcp' \
--header 'Content-Type: application/json' \
--data '{"method":"tools/list"}'

部署

  1. 链接您的Supabase项目:```bash
    supabase link --project-ref your-project-ref

1. **部署功能**:```bash
supabase functions deploy hello-world
  1. 部署所有功能:```bash
    supabase functions deploy

## 测试示例

### 1.你好,Hono MCP-添加工具```bash
# List available tools
curl -X POST 'http://localhost:54321/functions/v1/hello-hono-mcp/mcp' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call the add tool
curl -X POST 'http://localhost:54321/functions/v1/hello-hono-mcp/mcp' \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc":"2.0",
"id":2,
"method":"tools/call",
"params":{
"name":"add",
"arguments":{"a":5,"b":3}
}
}'

2.你好MCP处理器-骰子卷```bash

Roll a 6-sided die

curl -X POST 'http://localhost:54321/functions/v1/hello-mcp-handler/mcp' \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc":"2.0",
"id":1,
"method":"tools/call",
"params":{
"name":"roll_dice",
"arguments":{"sides":6}
}
}'


### 3.你好MCP Lite-多种工具```bash
# Calculator tool
curl -X POST 'http://localhost:54321/functions/v1/hello-mcp-lite/mcp' \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc":"2.0",
"id":1,
"method":"tools/call",
"params":{
"name":"add",
"arguments":{"a":10,"b":20}
}
}'

# Greeting tool
curl -X POST 'http://localhost:54321/functions/v1/hello-mcp-lite/mcp' \
-H 'Content-Type: application/json' \
-d '{
"jsonrpc":"2.0",
"id":2,
"method":"tools/call",
"params":{
"name":"greet",
"arguments":{"name":"Alice","language":"spanish"}
}
}'

4.服务器-经过身份验证的动态工具

此示例需要身份验证和数据库设置:```bash

First, get your JWT token from Supabase

TOKEN="your-jwt-token-here"

Call an authenticated MCP server

curl -X POST 'http://localhost:54321/functions/v1/server/YOUR_SERVER_ID/mcp' \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'


## 功能结构

每个边函数都遵循以下结构:```
supabase/functions//
├── index.ts          # Main function code
├── deno.json         # Deno configuration & dependencies
├── deno.lock         # Lock file for dependencies
└── .npmrc            # (Optional) npm configuration

关键概念

MCP协议基础

所有MCP服务器都使用基于HTTP的JSON-RPC 2.0:

  • 工具:执行操作(计算、数据获取等)的函数
  • 资源:客户端可以读取的数据源
  • 提示词:可以用参数填充的模板消息
  • 采样:LLM文本生成功能

HTTP端点

大多数MCP函数都公开了 /mcp 端点:```
https://your-project.supabase.co/functions/v1//mcp


### 请求格式```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tool_name",
"arguments": {
"param1": "value1"
}
}
}

响应格式```json

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Result content"
}
]
}
}


## 环境变量

某些函数需要环境变量:```bash
# For authenticated functions (server, verify-jwt)
SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-anon-key

# For AI-powered functions (server)
OPENAI_API_KEY=your-openai-key

在Supabase项目设置中设置这些,或 .env 本地开发文件。

依赖项

常见依赖关系

  • 荣誉:快速、轻量级的web框架
  • 黄道:TypeScript第一模式验证
  • @suabase/supabase-js:Supabase客户端库

MCP框架依赖关系

  • @模型上下文协议/sdk:官方MCP SDK(你好,hono-MCP)
  • mcp处理器:简化的MCP包装器(hello MCP处理程序、服务器)
  • mcp-lite:轻量级MCP实现(你好MCP-lite)
  • 电子邮件@hono/mcp:MCP的Hono集成(你好,Hono-MCP)

安装

在本地提供功能时,会自动安装依赖关系。检查每个功能 deno.json 对于特定的依赖关系。

高级示例

服务器功能-生产模式

这 server 函数演示了生产就绪模式:

  1. 认证:使用Supabase Auth进行JWT验证
  2. 数据库集成:从PostgreSQL动态加载工具
  3. 人工智能集成:OpenAI用于智能响应
  4. 多租户技术:用户特定的服务器配置

数据库模式 (服务器功能所需):```sql
-- Servers table
CREATE TABLE servers (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
user_id UUID REFERENCES auth.users(id),
name TEXT NOT NULL,
created_at TIMESTAMP DEFAULT NOW()
);

-- Tools table
CREATE TABLE tools (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
server_id UUID REFERENCES servers(id),
name TEXT NOT NULL,
description TEXT,
prompt TEXT,
created_at TIMESTAMP DEFAULT NOW()
);

-- Parameters table
CREATE TABLE parameters (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
tool_id UUID REFERENCES tools(id),
name TEXT NOT NULL,
type TEXT NOT NULL,
description TEXT,
created_at TIMESTAMP DEFAULT NOW()
);


## 故障排除

### 常见问题

1. **“找不到模块”错误**

- 检查 `deno.json` 正确的导入路径
- 确保使用JSR或npm URL指定依赖关系

1. **“未经授权”的错误**

- 验证是否设置了Supabase URL和anon键
- 检查授权标头格式: `Bearer `

1. **CORS错误**

- 大多数函数自动处理CORS
- 检查您的客户端是否发送了正确的标头

1. **功能超时**

- 边缘功能有2分钟的超时时间
- 优化长时间运行的操作
- 考虑将后台作业用于繁重的任务

### 调试模式

在函数中启用详细日志记录:```typescript
console.log('[DEBUG]', 'Request:', {
method: req.method,
url: req.url,
headers: Object.fromEntries(req.headers),
});

查看日志:bash supabase functions logs --follow

最佳实践

  1. 类型安全:对所有输入/输出使用TypeScript和Zod
  2. 错误处理:返回正确的HTTP状态代码和错误消息
  3. 认证:使用JWT验证保护敏感端点
  4. 验证:在处理之前验证所有用户输入
  5. 文档:记录所有工具、参数和预期响应
  6. 测试:在部署到生产环境之前进行本地测试
  7. 监控:设置日志记录和错误跟踪
  8. 安全:切勿在代码中暴露敏感凭据

资源

  • 模型上下文协议文档
  • 模型上下文协议规范
  • Supabase边缘函数
  • MCP TypeScript SDK
  • Hono框架
  • mcp处理器
  • mcp-lite

贡献

欢迎投稿!请随时通过以下方式提交拉取请求:

  • 新的MCP示例实现
  • 对现有示例的改进
  • 错误修复
  • 文档增强
  • 其他框架集成

许可证

MIT许可证-您可以在自己的项目中自由使用这些示例。

致谢

这些示例演示了在Supabase Edge Functions上构建MCP服务器的各种方法,展示了不同用例的不同框架和模式。


备注:这些示例从简单的演示到生产就绪模式。为您的用例选择适当的复杂性级别。这 server 函数演示企业级模式,而 hello-world 和 hello-hono 对于初学者来说,这是一个很好的起点。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP Edge Functions Examples 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Edge Functions Examples 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Edge Functions Examples 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Edge Functions Examples 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

MCP Edge Functions Examples 能提供哪些能力?

资料显示能力标签包括 边缘计算、服务器实现、TypeScript。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。