MCP Googlesheet Vendor

Google Sheets x402 MCP 服务器

一个MCP（模型上下文协议）服务器，通过x402支付协议提供对Google Sheets数据的访问。该服务器作为Claude Desktop（或任何MCP兼容客户端）与付费Google Sheets API之间的桥梁，自动使用您的以太坊钱包处理支付。

特点/功能

• 两种MCP工具：

- get_sheet获取特定Google表格数据，可选范围参数 - list-sheets列出API中所有可用的工作表

• 自动支付处理使用x402协议处理HTTP 402支付请求
• 基于以太坊的支付支付使用Base网络上的USDC（Sepolia测试网或主网）进行

先决条件

• Node.js（v20或更高版本）
• 一个与x402兼容的Google Sheets API服务器
• 一个支持USDC的以太坊钱包（在Base Sepolia测试网或Base主网上）
• 支持MCP的Claude Desktop

安装

1. 克隆此仓库：

git clone 
cd mcp-googlesheet-vendor

1. 安装依赖项：

npm install

1. 创建一个 .env 基于文件的（系统/方法/等） .env.example：

cp .env.example .env

1. 在您的环境中配置环境变量 .env：

PRIVATE_KEY=0xYourEthereumPrivateKeyHere
GOOGLESHEET_API_URL=http://localhost:4021

配置

环境变量

• PRIVATE_KEY您的以太坊钱包的私钥（用于支付签名）
• GOOGLESHEET_API_URL您的x402兼容的Google Sheets API的基础URL

用法

开发模式

以开发模式运行服务器，并启用自动重载：

npm run dev

生产模式

构建并运行编译后的服务器：

npm run build
npm start

添加到Claude Desktop

要在Claude Desktop中使用此MCP服务器：

1. 打开Claude桌面版并导航至MCP设置
2. 在您的（配置/设置中）添加以下配置 mcp_settings.json：

{
  "mcpServers": {
    "googlesheet-x402": {
      "command": "npm",
      "args": [
        "run",
        "--silent",
        "dev"
      ],
      "cwd": "/absolute/path/to/mcp-googlesheet-vendor",
      "env": {
        "PRIVATE_KEY": "0xYourEthereumPrivateKeyHere",
        "GOOGLESHEET_API_URL": "http://localhost:4021"
      }
    }
  }
}

1. 重启Claude桌面版
2. 这些工具现在将出现在Claude的工具面板中

可用的MCP工具

获取工作表

从特定的Google表格中获取数据。

参数：

• sheetId (字符串，必填)：用于从Google表格中获取数据的表格ID
• range （字符串，可选）：要获取的范围（例如，'Sheet1!A1:D10'）。如果未提供，则获取所有数据。

在Claude中的示例用法：

Can you fetch data from sheet ID "abc123" with range "Sheet1!A1:D10"?

列表表单

列出Google Sheets API中所有可用的工作表。

参数： 无

在Claude中的示例用法：

Show me all available sheets

它是如何运作的

1. 当Claude（或其他MCP客户端）调用工具时，MCP服务器会向您的x402兼容版Google Sheets API发送请求
2. 如果API需要支付（HTTP 402），x402-axios拦截器将自动：

- 检测支付需求 - 使用您的钱包创建并签署支付交易 - 提交付款 - 重试原始请求

1. API返回所请求的数据
2. MCP服务器将数据转发回Claude

安全注意事项

• 永远不要让你的 .env 泄露或公开你的私钥
• 使用测试网（Base Sepolia）进行开发
• 确保您的钱包中有足够的USDC用于API支付
• 安全地存储您的私钥

发展

项目结构

mcp-googlesheet-vendor/
├── server.ts           # Main MCP server implementation
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── .env.example        # Environment variables template
├── .gitignore         # Git ignore rules
└── README.md          # This file

构建x402 Google Sheets API

这个MCP服务器需要一个支持x402的API来处理Google Sheets数据。您需要：

1. 创建一个与Google Sheets API集成的API
2. 实现x402支付要求（HTTP 402响应）
3. 在Base网络上接受USDC支付
4. 成功支付后返回表格数据

参考 x402协议文档 关于实施细节。

故障排除

• 模块未找到错误跑 npm install 确保所有依赖项都已安装
• 支付失败检查您的钱包是否已存入足够的USDC，并确保已配置正确的网络
• API连接错误验证您的 GOOGLESHEET_API_URL 原文内容是正确的，且API正在运行
• MCP连接问题确保 cwd 在您的MCP设置中，路径指向的是正确的目录

许可证

麻省理工学院（MIT）