<a name="top"></a>

ToolsForMCPServer-extension (ToolsForMCPServer作为Gemini扩展)

此MCP服务器的名称是tools-for-mcp-server-extension。基础的MCP服务器来自https://github.com/tanaikech/ToolsForMCPServer。

<a name="abstract"></a>

描述

Gemini CLI持续发展，最近发布了Gemini CLI扩展。参考这些扩展允许通过简单的命令自动安装自定义命令、MCP服务器等。我认为这个扩展对于我的MCP服务器工具ToolsForMCPServer是有用的。此仓库允许通过Gemini CLI扩展安装ToolsForMCPServer。

如何安装ToolsForMCPServer-extension

1. 安装Gemini CLI和默认设置

1. 安装Gemini CLI

npm install -g @google/gemini-cli

2. 授权

授权详情请参见https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-authentication-options。

2. 复制一个Google Apps Script项目

登录到您的Google账户后，使用浏览器访问以下URL。然后，点击右上角的复制按钮来复制项目。

https://script.google.com/home/projects/1Qm9LgtuQLxDzdLUoJPrOEpmyTBivZZsCLiSUC7q-D3Gi4fISvxgcITWb

这样，复制的Google Apps Script项目会自动打开。

3. 部署Web Apps

为了让Gemini CLI能够与我们的脚本通信，我们必须将其部署为Web应用。这将创建一个唯一的URL，作为我们的MCP服务器端点。

您可以在官方文档中找到详细信息。

请按照以下步骤在脚本编辑器中部署Web应用：

1. 在脚本编辑器的右上角，点击部署 -> 新建部署。
2. 点击选择类型 -> Web应用。
3. 在“部署配置”下的字段中输入Web应用的描述。
4. 选择“执行者”为**“我”**。这是至关重要的，因为它允许脚本以您的权限运行，从而访问您的Google服务。
5. 选择“谁有访问权”为**“任何人”**。这使得URL可以从互联网调用。访问由不可猜测的URL和脚本中定义的accessKey控制。
6. 点击部署。
7. 在授权必要的范围后，复制Web应用URL。它看起来类似于https://script.google.com/macros/s/###/exec。这就是您的MCP服务器端点。

重要： 当您修改Apps Script代码时，必须创建一个新的部署版本来发布更改。点击部署 > 管理部署，选择您的活动部署，点击铅笔图标，并从“版本”下拉菜单中选择**“新版本”**。更多信息在这里。

4. 环境变量

此MCP服务器使用以下两个环境变量。请设置它们。

用于Gemini API的API密钥。（根据环境的不同，此变量可能已经设置用于Gemini CLI和Gemini API。）

export GEMINI_API_KEY="{您的API密钥}"

从上述部分获取的Web Apps URL。

export MCP_WEB_APPS_URL="https://script.google.com/macros/s/###/exec?accessKey=sample"

这里，accessKey=sample中的sample来自于Google Apps Script "ToolsForMCPServer_project"中的new MCPApp.mcpApp({ accessKey: "sample" })。当您想要修改访问密钥时，请同时修改这两个地方。并且重新部署Web Apps以反映最新的脚本。

例如，这些变量可以设置到.bashrc或.bash_profile文件中（针对bash）。

5. 安装Gemini扩展

在终端上运行以下命令。

gemini extensions install https://github.com/tanaikech/ToolsForMCPServer-extension

6. 测试

在终端上运行以下命令。

gemini

当Gemini CLI打开时，运行以下命令。

/mcp

如果您可以看到来自MCP服务器的工具，则设置已完成。

示例提示

使用此MCP服务器工具的示例提示如下。

• Gemini CLI与MCP服务器：通过Google Apps Script扩展可能性
• Gemini CLI：增强版ToolsForMCPServer
• 数据自动化提升：Gemini CLI、Google表格和MCP
• 通过自然语言管理Google文档、表格和幻灯片：Gemini CLI和MCP
• 数据自动化提升：Gemini CLI、Google日历和MCP
• 使用提示的增强指南：Gemini CLI
• 课堂自动化提升：Gemini CLI、Google课堂和MCP
• 统一Google工作区：通过自然语言实现集成协作：Gemini CLI和MCP
• 简化网页洞察：通过自然语言使用Gemini CLI、Google Analytics和MCP
• Google地图与自然语言：通过Gemini CLI和MCP实现集成协作
• 简化内容创作：使用Gemini CLI、MCP服务器和VSCode的指南
• 从数据孤岛到统一RAG：Gemini CLI扩展统一本地和Google工作区，实现强大的文件搜索

---

<a name="licence"></a>

许可证

MIT

<a name="author"></a>

作者

Tanaike

捐赠

<a name="updatehistory"></a>

更新历史

• v1.0.0 (2025年10月15日)

  1. 初始发布。

• v1.1.0 (2025年10月31日)

  1. 在gemini-extension.json中添加了timeout。

• v1.2.0 (2025年11月14日)

  1. 移除了MCP服务器"workspace-developer"。这是因为更新Gemini CLI到v0.15.0或v0.17.0-nightly.20251114.0fcbff506导致了以下错误：

     ✕ 从workspace-developer发现工具时出错：无法解析引用#/$defs/SearchResult的id#
     ✕ 发现服务器'workspace-developer'时出错：未在服务器上找到任何提示或工具。
     

  2. 增加了11个用于管理文件搜索的工具。 这些工具的基础脚本是使用Google Apps Script创建的。参考

     • file_search_gas_create
     • file_search_gas_documents_get
     • file_search_gas_documents_list
     • file_search_gas_documents_query
     • file_search_gas_documents_remove
     • file_search_gas_generate_content
     • file_search_gas_get
     • file_search_gas_import_file
     • file_search_gas_list
     • file_search_gas_media_upload
     • file_search_gas_remove

TOP