适用于Vibin Coders SaaS加速器的自定义MCP服务器

此目录包含用于Supabase、Stripe和Playwright集成的自定义MCP（模型上下文协议）服务器。

快速设置

1. 安装依赖项：

   npm install --prefix ./mcp-servers
   

2. 配置环境变量：

   cd mcp-servers
   cp .env.example .env
   # 使用实际值编辑.env文件
   

3. 更新Claude Code配置： MCP服务器已经在Claude Code中进行了配置，但你需要在你的~/.claude.json文件中更新环境变量：

   {
     "supabase": {
       "env": {
         "SUPABASE_URL": "https://your-project.supabase.co",
         "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
       }
     },
     "stripe": {
       "env": {
         "STRIPE_SECRET_KEY": "sk_test_your-secret-key"
       }
     },
     "playwright": {
       "env": {
         "PLAYWRIGHT_HEADLESS": "true"
       }
     }
   }
   

MCP服务器功能

Supabase MCP服务器

• supabase_query - 执行原始SQL查询
• supabase_insert - 将数据插入表中
• supabase_select - 使用过滤器选择数据
• supabase_update - 更新表记录
• supabase_create_table - 创建新表
• supabase_get_schema - 获取数据库模式信息

Stripe MCP服务器

• stripe_create_product - 创建产品
• stripe_create_price - 创建定价计划
• stripe_list_products - 列出所有产品
• stripe_list_prices - 列出所有价格
• stripe_create_checkout_session - 创建支付会话
• stripe_create_customer_portal - 创建管理门户
• stripe_get_customer - 检索客户信息
• stripe_create_customer - 创建新客户
• stripe_get_subscription - 获取订阅详情
• stripe_list_webhooks - 列出Webhook端点

Playwright MCP服务器

• playwright_navigate - 导航到URL
• playwright_click - 点击元素
• playwright_fill - 填写表单字段
• playwright_get_text - 获取元素文本
• playwright_screenshot - 截图
• playwright_wait_for_selector - 等待元素
• playwright_evaluate - 运行JavaScript
• playwright_get_title - 获取页面标题
• playwright_get_url - 获取当前URL
• playwright_check_element_exists - 检查元素是否存在
• playwright_close_browser - 关闭浏览器实例
• playwright_new_page - 创建新的页面/标签页

测试MCP服务器

测试各个服务器：

# 测试Supabase服务器
node supabase-mcp/index.js

# 测试Stripe服务器
node stripe-mcp/index.js

# 测试Playwright服务器
node playwright-mcp/index.js

需要的环境变量

Supabase

• SUPABASE_URL - 你的Supabase项目URL
• SUPABASE_SERVICE_ROLE_KEY - 服务角色密钥（具有管理员访问权限）
• SUPABASE_ANON_KEY - 匿名密钥（可选）

Stripe

• STRIPE_SECRET_KEY - 你的Stripe密钥（开发时使用测试密钥）
• STRIPE_PUBLISHABLE_KEY - 你的Stripe发布密钥（可选）

Playwright

• PLAYWRIGHT_HEADLESS - 在无头模式下运行浏览器（true/false）
• PLAYWRIGHT_BROWSER - 浏览器类型（chromium/firefox/webkit）

在Claude Code中的使用

配置完成后，你可以在提示中使用这些工具：

使用Supabase MCP创建一个subscription_plans表，列包括id、name、price、stripe_price_id、features、active。

然后使用Stripe MCP为Pro（$29/月）和Business（$99/月）计划创建产品。

最后，使用Playwright MCP测试定价页面是否正确加载。

故障排除

1. 连接失败： 检查环境变量是否设置正确
2. 权限错误： 确保服务角色密钥具有适当的权限
3. 模块错误： 在mcp-servers目录中运行npm install
4. Playwright浏览器错误： 运行npx playwright install以安装浏览器

手动配置更新

如果你需要手动更新MCP服务器配置，请编辑~/.claude.json并在mcpServers部分更新环境变量。

或者删除并重新添加服务器：

claude mcp remove supabase
claude mcp add supabase --env SUPABASE_URL=your-url --env SUPABASE_SERVICE_ROLE_KEY=
your-key -- node /path/to/supabase-mcp/index.js