Gmail Notes Server

🚀 Gmail-MCP MCP 服務器

這是一個基於 TypeScript 和 Gmail API 構建的 Gmail MCP 服務器，它展示了核心 MCP 概念。該服務器允許使用 note:// URI 和元數據表示文本筆記資源，提供創建新筆記的工具，還能生成筆記摘要的提示。

🚀 快速開始

Gmail-MCP MCP 服務器提供了便捷的使用方式，你可以通過 Smithery 自動安裝，也能手動進行安裝。同時，還提供了開發和調試的相關命令。

✨ 主要特性

資源

• 可列出和訪問使用 note:// URI 的筆記。
• 每個筆記包含標題、內容和元數據。
• 使用純文本 MIME 類型提供簡單的內容訪問。

工具

• create_note：用於創建新的文本筆記，標題和內容為必填參數，創建的筆記將存儲在服務器狀態中。

提示

• summarize_notes：生成所有存儲筆記的摘要，包括所有筆記內容作為嵌入資源，並返回結構化的提示以供 LLM 進行總結。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Gmail 筆記服務器以供 Claude Desktop 使用，可執行以下命令：

npx -y @smithery/cli install @mundume/gmail-mcp --client claude

手動安裝

要與 Claude Desktop 一起使用，請添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "/path/to/gmail-mcp/build/index.js"
    }
  }
}

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本提供，執行以下命令：

npm run inspector

Inspector 將提供訪問瀏覽器中的調試工具的 URL。

💻 使用示例

基礎用法

安裝依賴

npm install

構建服務器

npm run build

帶有自動重建功能的開發

npm run watch