Google Mcp

开发 TypeScript

🚀 Google MCP 服务器

Google MCP 服务器是一个全面的模型上下文协议（MCP）服务器，它通过统一的 API 提供对谷歌多项服务的访问，这些服务涵盖地图、金融、航班、Gmail 以及日历。

✨ 主要特性

🗺️ 谷歌地图与地点服务

地理编码：实现地址与坐标之间的相互转换。
地点搜索：查找企业、地标以及名胜古迹。
路线规划：获取两地之间的逐向导航路线。
距离矩阵：计算多个地点之间的旅行时间和距离。
地点详情：获取特定地点的详细信息。

📈 谷歌金融服务

股票搜索：搜索股票、指数、共同基金、货币以及期货。
市场数据：获取当前价格、走势以及市场信息。
财经新闻：访问与证券相关的顶级财经新闻。

✈️ 谷歌航班服务

机场搜索：查找航班和机场信息。
航班定价：获取航班价格和相关见解。
多城市行程：支持复杂的多目的地旅行。

📧 Gmail 服务

发送邮件：发送包含主题、正文、抄送和密送的邮件。
读取邮件：使用 Gmail 查询语法列出和搜索邮件。
邮件详情：通过邮件 ID 获取完整的邮件内容。
标签管理：访问 Gmail 标签和组织架构。

📅 谷歌日历服务

事件管理：创建、读取、更新和删除日历事件。
多日历支持：支持多个日历（个人、工作、旅行）。
事件列表：根据过滤器和日期范围列出事件。
日历管理：列出和访问不同的日历。

📦 安装指南

前提条件

Node.js 18+
pnpm（推荐）或 npm

安装步骤

克隆仓库：
```
git clone 
cd google-mcp
```
安装依赖：
```
pnpm install
```
构建项目：
```
pnpm run build
```

MCP 客户端集成

将服务器安装到你首选的 MCP 客户端：

# 安装到所有 MCP 客户端
pnpm run install-server

# 安装到特定客户端
pnpm run install-desktop    # Claude Desktop
pnpm run install-cursor     # Cursor IDE
pnpm run install-code       # Claude Code
pnpm run install-mcp        # 仅本地 .mcp.json

📚 详细文档

配置

环境变量

在项目根目录下创建一个 .env.local 文件，并填入你的谷歌 API 凭证：

GOOGLE_MAPS_API_KEY=your_google_maps_api_key
GOOGLE_CLIENT_ID=your_oauth_client_id
GOOGLE_CLIENT_SECRET=your_oauth_client_secret
GOOGLE_REFRESH_TOKEN=your_refresh_token

谷歌 API 设置

谷歌地图 API：在谷歌云控制台中启用地图、地点和路线规划 API。
Gmail/日历：设置 OAuth 2.0 凭证并获取刷新令牌。
金融/航班：使用谷歌的公共 API（无需额外设置）。

使用方法

运行服务器

# 启动编译后的服务器
pnpm start

# 或者在开发模式下运行
node dist/index.js

可用工具

地图与地点服务

geocode - 将地址转换为坐标
reverse-geocode - 将坐标转换为地址
places-search - 通过文本查询搜索地点
get-directions - 获取两地之间的路线
distance-matrix - 计算多个地点之间的距离
place-details - 获取特定地点的详细信息

金融服务

finance-search - 搜索股票、货币和金融工具

航班服务

airports-search - 搜索航班和机场信息

Gmail 服务

gmail-send-email - 发送邮件
gmail-read-emails - 列出/搜索邮件
gmail-get-email - 通过 ID 获取特定邮件
gmail-get-labels - 列出 Gmail 标签

日历服务

calendar-create-event - 创建新事件
calendar-list-events - 根据过滤器列出事件
calendar-get-event - 获取特定事件的详细信息
calendar-update-event - 更新现有事件
calendar-delete-event - 删除事件
calendar-list-calendars - 列出可用的日历

🔧 技术细节

项目结构

src/
├── index.ts       # 主 MCP 服务器实现
├── maps.ts        # 谷歌地图与地点功能
├── finance.ts     # 谷歌金融集成
├── airports.ts    # 谷歌航班集成
├── gmail.ts       # Gmail API 集成
└── calendar.ts    # 谷歌日历集成

scripts/
└── update-config.js   # MCP 客户端配置安装程序

dist/             # 编译后的 JavaScript 输出

关键技术

MCP SDK：使用 @modelcontextprotocol/sdk 实现协议。
模式验证：使用 Zod 进行运行时类型检查。
谷歌 API：使用官方谷歌客户端库。
TypeScript：以 ES2022 为目标，实现完全的类型安全。
传输层：使用 StdioServerTransport 进行 MCP 通信。

开发工作流

在 src/ 目录下的 TypeScript 文件中进行修改。
构建项目：pnpm run build
测试：pnpm start
安装到客户端：pnpm run install-server
重启 MCP 客户端以加载更改。

添加新工具

为参数定义 Zod 模式。
实现处理函数。
使用 server.tool() 在 src/index.ts 中注册工具。
构建并重新安装以进行测试。

架构设计

此 MCP 服务器遵循以下设计模式：

模块化设计：每个谷歌服务都位于其自己的模块中。
模式验证：所有参数都使用 Zod 模式进行验证。
错误处理：全面的错误处理，提供有意义的错误消息。
类型安全：完全使用 TypeScript 覆盖，并启用严格模式。
传输无关性：使用 MCP 的标准传输层。

📄 许可证

[License information]

贡献说明

[Contribution guidelines]

0 条评论
分类：开发