MCP 服务器

Google Workspace MCP Server

这是一个用 TypeScript 编写的 G_chat Mcp 服务器，包含各种用于获取和发布内容的工具。

KaranThink41

开发者工具

访问服务器

README

Google Workspace MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Gmail 和 Calendar API 交互的工具。此服务器使您能够通过 MCP 接口以编程方式管理您的电子邮件和日历事件。

功能

Gmail 工具

list_emails: 列出收件箱中最近的电子邮件，并可选择过滤
search_emails: 使用 Gmail 查询语法进行高级电子邮件搜索
send_email: 发送新电子邮件，支持抄送和密送
modify_email: 修改电子邮件标签（存档、垃圾箱、标记为已读/未读）

Calendar 工具

list_events: 列出即将到来的日历事件，并按日期范围过滤
create_event: 创建包含参与者的新日历事件
update_event: 更新现有日历事件
delete_event: 删除日历事件

前提条件

Node.js: 安装 Node.js 14 或更高版本
Google Cloud Console 设置:
- 转到 Google Cloud Console
- 创建一个新项目或选择一个现有项目
- 启用 Gmail API 和 Google Calendar API：
  1. 转到“API 和服务”>“库”
  2. 搜索并启用“Gmail API”
  3. 搜索并启用“Google Calendar API”
- 设置 OAuth 2.0 凭据：
  1. 转到“API 和服务”>“凭据”
  2. 单击“创建凭据”>“OAuth 客户端 ID”
  3. 选择“Web 应用程序”
  4. 将“授权重定向 URI”设置为包含：http://localhost:3000/auth/callback
  5. 记下客户端 ID 和客户端密钥

通过 Smithery 安装

使用 Smithery 的 CLI 安装服务器：

npx spinai-mcp install @KaranThink41/gsuite-mcp-server --provider smithery --config '{"googleClientId":"your_google_client_id","googleClientSecret":"your_google_client_secret","googleRefreshToken":"your_google_refresh_token"}'

或者，您可以使用以下配置：

// smithery.config.js
export default {
  KaranThink41_google_chat_mcp_server: {
    command: 'npx',
    args: [
      '-y',
      '@smithery/cli@latest',
      'run',
      '@KaranThink41/google_chat_mcp_server'
    ]
  },
};

本地开发（可选）

如果您希望在本地运行服务器：

克隆存储库：

git clone https://github.com/KaranThink41/Google_workspace_mcp_server.git
cd Google_workspace_mcp_server

安装依赖项：

npm install

构建项目：

npm run build

运行服务器：

node build/index.js

使用示例

Gmail 操作

列出最近的电子邮件:

{
  "maxResults": 5,
  "query": "is:unread"
}

搜索电子邮件:

{
  "query": "from:example@gmail.com has:attachment",
  "maxResults": 10
}

发送电子邮件:

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message content",
  "cc": "cc@example.com",
  "bcc": "bcc@example.com"
}

修改电子邮件:

{
  "id": "message_id",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

Calendar 操作

列出事件:

{
  "maxResults": 10,
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z"
}

创建事件:

{
  "summary": "Team Meeting",
  "location": "Conference Room",
  "description": "Weekly sync-up",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["colleague@example.com"]
}

更新事件:

{
  "eventId": "event_id",
  "summary": "Updated Meeting Title",
  "location": "Virtual",
  "start": "2024-01-24T11:00:00Z",
  "end": "2024-01-24T12:00:00Z"
}

删除事件:
```
{
  "eventId": "event_id"
}
```

故障排除

身份验证问题:
- 确保已授予所有必需的 OAuth 范围
- 验证客户端 ID 和密钥是否正确
- 检查刷新令牌是否有效
API 错误:
- 检查 Google Cloud Console 中的 API 配额和限制
- 确保为您的项目启用了 API
- 验证请求参数是否与所需格式匹配

许可证

此项目根据 MIT 许可证获得许可。

Google Chat MCP 服务器

一个用于与 Google Chat API 交互的模型上下文协议 (MCP) 服务器实现。此服务器提供用于管理 Google Chat 中的消息、空间和成员资格的工具。

功能

将文本消息发布到 Google Chat 空间
获取空间详细信息并列出空间
管理成员资格（列出、获取成员详细信息）
列出和检索具有过滤功能的消息
自然语言过滤支持

设置说明

1. Google Cloud 项目设置

转到 Google Cloud Console
创建一个新项目或选择一个现有项目
启用 Google Chat API
创建 OAuth 2.0 凭据：
- 转到 API 和服务 > 凭据
- 单击“创建凭据”>“OAuth 客户端 ID”
- 选择“Web 应用程序”
- 将“授权重定向 URI”设置为包含：http://localhost:3000/auth/callback
- 记下客户端 ID 和客户端密钥

2. 获取刷新令牌

创建一个临时凭据文件：

cp temp-credentials.json.example temp-credentials.json

使用您的客户端 ID 和客户端密钥更新 temp-credentials.json
运行刷新令牌脚本：

node get-refresh-token.js

按照浏览器身份验证流程获取刷新令牌

3. 通过 Smithery 安装

使用 Smithery 的 CLI 安装服务器：

npx spinai-mcp install @KaranThink41/google_chat_mcp_server --provider smithery --config '{"spaceId":"your_space_id","googleClientId":"your_google_client_id","googleClientSecret":"your_google_client_secret","googleRefreshToken":"your_google_refresh_token"}'

或者，您可以使用以下配置：

export default {
  KaranThink41_google_chat_mcp_server: {
    command: 'npx',
    args: [
      '-y',
      '@smithery/cli@latest',
      'run',
      '@KaranThink41/google_chat_mcp_server'
    ]
  },
};

4. 本地开发（可选）

如果您希望在本地运行服务器：

克隆存储库：

git clone https://github.com/KaranThink41/Google_chat_mcp_server.git
cd Google_chat_mcp_server

安装依赖项：

npm install

构建项目：

npm run build

运行服务器：

node build/index.js

可用工具

消息管理

post_text_message: 将文本消息发布到 Google Chat 空间

{
  "method": "tools/call",
  "params": {
    "name": "post_text_message",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "text": "Hello, this is a test message!"
    }
  }
}

fetch_message_details: 获取有关特定消息的详细信息

{
  "method": "tools/call",
  "params": {
    "name": "fetch_message_details",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "messageId": "cpwLU-2f_z8.cpwLU-2f_z8"
    }
  }
}

list_space_messages: 列出空间中的消息，并可选择过滤

{
  "method": "tools/call",
  "params": {
    "name": "list_space_messages",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "pageSize": 10,
      "orderBy": "createTime"
    }
  }
}

空间管理

fetch_space_details: 获取有关空间的全面详细信息

{
  "method": "tools/call",
  "params": {
    "name": "fetch_space_details",
    "arguments": {
      "spaceId": "AAAAfkdUqxE"
    }
  }
}

list_joined_spaces: 列出调用者是成员的所有空间

{
  "method": "tools/call",
  "params": {
    "name": "list_joined_spaces",
    "arguments": {
      "pageSize": 10
    }
  }
}

成员资格管理

list_space_memberships: 列出空间中的所有成员资格

{
  "method": "tools/call",
  "params": {
    "name": "list_space_memberships",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "pageSize": 10
    }
  }
}

fetch_member_details: 获取有关特定成员的详细信息

{
  "method": "tools/call",
  "params": {
    "name": "fetch_member_details",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "memberId": "user_123"
    }
  }
}

自然语言过滤

apply_natural_language_filter: 将自然语言查询转换为 API 过滤器字符串

{
  "method": "tools/call",
  "params": {
    "name": "apply_natural_language_filter",
    "arguments": {
      "filterText": "messages from Monday"
    }
  }
}

错误处理

服务器实现了适当的错误处理，并提供描述性错误消息。常见错误包括：

身份验证失败
无效的空间 ID
速率限制
超出 API 配额

安全

所有敏感凭据都存储在环境变量中
OAuth 刷新令牌得到安全管理
API 密钥永远不会在代码中公开

贡献

Fork 存储库
创建您的功能分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个 Pull Request

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。