MCP Workspace

MCP服务器存储库

此存储库包含各种MCP（模型上下文协议）服务器的配置、文档和服务器实现。

📦 MCP服务器

团队合作MCP（Node.js）⭐ 活跃的

• 路径: servers/teamwork/community/vizioz-teamwork-mcp
• 语言：Types/Node.js
• 状态：生产中使用的工作实施
• 特性：团队合作与日历、项目、任务、时间跟踪等集成
• 文档: docs/TEAMWORK_MCP_SETUP.md

电报MCP（Python）⭐ 活跃的

• 路径: servers/telegram/telegram-mcp
• 语言python
• 状态：生产中使用的工作实施
• 特性：电报消息和聊天管理
• 文档: docs/TELEGRAM_MCP_SETUP.md

微软Outlook MCP（Node.js）⭐ 活跃的

• 路径: servers/outlook/community/simply-outlook-mcp
• 语言：Types/Node.js
• 状态：工作实施-最近整合
• 特性：电子邮件管理、日历操作（读/写）、搜索、发送/回复
• 局限性：没有任务管理、联系人或附件
• 文档: docs/OUTLOOK_MCP_SETUP.md

WhatsApp MCP（Go/Python）⭐ 活跃的

• 路径: servers/whatsapp/community/whatsapp-mcp
• 语言：Go（桥接）+Python（MCP服务器）
• 状态：工作实施-最近整合
• GitHub: https://github.com/lharries/whatsapp-mcp（约4.8k颗星）
• 特性：读取/发送消息、媒体支持（图像/视频/音频）、联系人搜索、群消息
• 隐私：消息存储在SQLite本地，仅在访问时发送给Claude
• 文档：参见 servers/whatsapp/README.md

官方团队合作MCP（Go）📚 仅供参考

• 路径: servers/teamwork/official/teamwork-mcp
• 语言：去吧
• 状态：参考实现-未安装或运行
• 目的：用于在向vizioz团队合作mcp添加功能时研究实现细节
• 文档：检查子模块README

架构说明当我们需要Teamwork MCP中的新功能时，我们参考官方的Go实现来了解它是如何工作的，然后在我们的vizioz Teamwork MCP Node.js服务器中实现逻辑。

🚀 快速开始

1.克隆存储库

git clone https://github.com/philipdalen/mcp.git
cd mcp

2.安装所有服务器

make install

这将：

• 为Teamwork MCP（vizioz Teamwork MCP）安装Node.js依赖项
• 为Telegram MCP安装Python依赖项

3.安装单个服务器（可选）

make install-teamwork         # Install only Teamwork MCP (Node.js)
make install-telegram         # Install only Telegram MCP (Python)

3.查看所有可用命令

make help

📘 需要详细的安装说明吗？ 看 设置.md 获取全面的安装指南、故障排除和手动安装步骤。

📁 存储库结构

mcp/
├── Makefile                    # Installation and setup automation
├── README.md                   # This file
├── SETUP.md                    # Detailed installation guide
├── configs/                    # Example configuration files
│   ├── teamwork-mcp-config-bearer.json
│   └── telegram-mcp-config-example.json
├── docs/                       # Documentation
│   ├── AUTH_GUIDE.md
│   ├── NOTEBOOK_OPERATIONS.md
│   ├── OUTLOOK_MCP_SETUP.md
│   ├── TEAMWORK_MCP_SETUP.md
│   └── TELEGRAM_MCP_SETUP.md
├── examples/                   # Usage examples
├── logs/                       # Log files
└── servers/                    # MCP server implementations
    ├── outlook/
    │   └── community/         # Simply Outlook MCP (Node.js)
    ├── teamwork/
    │   ├── official/          # Official Teamwork MCP (Go)
    │   └── community/         # Community Teamwork MCP (Node.js)
    ├── telegram/              # Telegram MCP (Python)
    └── whatsapp/
        └── community/         # WhatsApp MCP (Go + Python)

🔧 先决条件

根据您要使用的服务器，您需要：

• Node.js （18+）-适用于团队合作MCP、Outlook MCP

- 安装：https://nodejs.org/

• python （3.9+）-适用于Telegram MCP、WhatsApp MCP

- 安装：https://www.python.org/downloads/

• 去 -适用于WhatsApp MCP（桥接组件）

- 安装：https://go.dev/doc/install

• 紫外线 （Python包管理器）-适用于WhatsApp MCP

- 安装： curl -LsSf https://astral.sh/uv/install.sh | sh

• FFmpeg (_可选的_)-用于WhatsApp音频消息

- 安装：https://ffmpeg.org/download.html

备注：Go仅适用于WhatsApp MCP服务器。官方的Teamwork MCP（Go）仅作为研究如何构建功能的参考实现。

📖 设置指南

团队合作MCP快速设置

1.获取您的不记名代币

npx @teamwork/get-bearer-token

2.配置IDE

将此添加到您的Windsurf/Cursor/Claude Desktop MCP配置中：

{
  "mcpServers": {
    "teamwork": {
      "serverUrl": "https://mcp.ai.teamwork.com",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

有关详细的设置说明，请参阅 docs/TEAMWORK_MCP_SETUP.md.

电报MCP快速设置

看 docs/TELEGRAM_MCP_SETUP.md 有关完整的设置说明。

Microsoft Outlook MCP快速安装

1.创建Azure AD应用程序

首选 Azure 门户，创建应用程序注册，并启用设备代码流。

2.身份验证

cd servers/outlook/community/simply-outlook-mcp
npx simply-outlook-mcp --auth --client_id YOUR_CLIENT_ID

3.配置IDE

将此添加到MCP配置中：

{
  "mcpServers": {
    "outlook": {
      "command": "node",
      "args": [
        "/path/to/servers/outlook/community/simply-outlook-mcp/dist/index.js"
      ],
      "env": {
        "SIMPLY_OUTLOOK_MCP_CLIENT_ID": "YOUR_CLIENT_ID"
      }
    }
  }
}

有关详细的设置说明，请参阅 docs/OUTLOOK_MCP_SETUP.md.

WhatsApp MCP快速设置

1.运行WhatsApp桥

cd servers/whatsapp/community/whatsapp-mcp/whatsapp-bridge
go run main.go

使用手机上的WhatsApp扫描二维码进行身份验证。

2.配置IDE

将此添加到MCP配置中：

{
  "mcpServers": {
    "whatsapp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/mcp/servers/whatsapp/community/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

有关详细的设置说明，请参阅 servers/whatsapp/community/whatsapp-mcp/README.md.

📚 包含什么

团队合作MCP功能

• ✅ 笔记本（创建、更新、删除、列出）
• ✅ 项目和任务管理
• ✅ 用户、团队和公司
• ✅ 里程碑、标签和评论
• ✅ 时间日志和计时器
• ✅ 负载管理
• ✅ 30+工具可用

Telegram MCP功能

• ✅ 发送和接收消息
• ✅ 聊天管理
• ✅ 联系人管理
• ✅ 集团和渠道运营
• ✅ 介质处理
• ✅ 50多种可用工具

Microsoft Outlook MCP功能

• ✅ 日历事件（获取、创建、更新、邀请与会者）
• ✅ 电子邮件操作（阅读、发送、搜索、回复）
• ✅ 分页支持
• ✅ OAuth 2.0身份验证
• ✅ 选择性工具控制
• ❌ 无任务管理（Microsoft待办事项）
• ❌ 无联系人管理
• ❌ 附件支持有限

WhatsApp MCP功能

• ✅ 搜索和阅读个人WhatsApp消息
• ✅ 媒体支持（图像、视频、文档、音频）
• ✅ 联系人搜索
• ✅ 向个人或团体发送消息
• ✅ 发送媒体文件（图像、视频、音频、文档）
• ✅ 从消息中下载媒体
• ✅ 语音消息支持（使用FFmpeg）
• ✅ 本地SQLite存储以保护隐私
• ✅ 通过Web API直接连接到个人WhatsApp
• ✅ 12+可用工具

🛠️ Makefile命令

make help                      # Show all available commands
make install                   # Install all MCP servers
make install-teamwork          # Install Teamwork MCP only (Node.js)
make install-telegram          # Install Telegram MCP only (Python)
make clean                     # Remove all installed dependencies

📖 文档

• 安装指南: SETUP.md -全面的安装、故障排除和手动设置
• Microsoft Outlook安装程序: docs/OUTLOOK_MCP_SETUP.md
• 团队设置: docs/TEAMWORK_MCP_SETUP.md
• 团队合作笔记本操作: docs/NOTEBOOK_OPERATIONS.md
• 电报设置: docs/TELEGRAM_MCP_SETUP.md
• 身份验证指南: docs/AUTH_GUIDE.md
• 团队合作API文档: https://apidocs.teamwork.com/
• MCP代表团队合作: https://github.com/Teamwork/mcp
• 简单展望MCP回购: https://github.com/hmmroger/simply-outlook-mcp

💡 示例用法

团队合作示例

Create a markdown notebook in project 12345 called "Sprint Planning"
with our Q1 goals

List all notebooks in project 12345 tagged with "documentation"

Show me all overdue tasks assigned to me

电报示例

Send a message to chat ID 12345

List my recent conversations

Search for messages containing "meeting notes" in chat 67890

Microsoft Outlook示例

Show me my calendar events for next week

Create a calendar event for tomorrow at 2pm titled "Team Meeting"

Search my emails for messages from john@example.com

Send an email to jane@example.com with subject "Project Update"

WhatsApp示例

Search for messages containing "project deadline" in my WhatsApp

Send a WhatsApp message to John Smith saying "Meeting is at 3pm"

Show me my recent WhatsApp conversations

Send an image to the "Team" group

Download the latest media file from my chat with Sarah

🆘 需要帮助？

• 查看中的设置指南 docs/ 目录
• 访问 团队合作支持
• 检查
• 检查
• 检查
• 检查
• 对于Azure AD问题： Microsoft Entra文档

🤝 贡献

欢迎投稿！每台服务器都有自己的存储库：

• 官方团队合作MCP：https://github.com/Teamwork/mcp
• 社区团队合作MCP：https://github.com/philipdalen/Teamwork-MCP
• 电报MCP：https://github.com/philipdalen/telegram-mcp
• 简单地查看MCP：https://github.com/hmmroger/simply-outlook-mcp
• WhatsApp MCP：https://github.com/lharries/whatsapp-mcp

📝 许可证

每个MCP服务器都有自己的许可证。请检查各个服务器目录中的许可证信息。

______________________________________________________________________

状态: ✅ 即用型-多个MCP服务器（团队合作、电报、Outlook、WhatsApp），功能全面