Metadata-Version: 2.4
Name: mcp-server-wecom-doc
Version: 1.0.0
Summary: 企业微信文档 MCP Server - 读取企微在线文档内容（文字+图片+链接）
Author: mcp-server-wecom-doc
License: MIT
Keywords: mcp,wecom,weixin,doc,enterprise-wechat
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: python-dotenv>=1.0.0

# mcp-server-wecom-doc

企业微信文档 MCP Server - 通过 MCP 协议读取企微在线文档内容。

## 功能

- ✅ 读取企微在线文档的文字内容（支持 w3_/e2_ 等普通文档类型）
- ✅ 下载并识别文档中的图片（架构图、流程图、截图等）
- ✅ 提取表格中的超链接
- ✅ 多 Sheet Tab 支持（在线表格）
- ✅ 行级关联模式（逐行关联文字、图片、链接）
- ✅ 自动从已登录浏览器导出 Cookie
- ✅ 优先使用本地 Chrome/Edge，无需额外安装 Chromium

## 快速开始

### MCP 配置

```json
{
  "mcpServers": {
    "wecom-doc": {
      "command": "uvx",
      "args": ["mcp-server-wecom-doc"]
    }
  }
}
```

### 使用流程

1. **导出 Cookie**：运行 `export_cookies` 工具，会自动打开本地 Chrome 浏览器窗口，登录企微文档后自动保存 Cookie
2. **读取文档**：运行 `read_doc` 工具，传入企微文档 URL 即可获取内容
3. **读取含图片的文档**：`read_doc` 设置 `with_images: true`

### 浏览器要求

- **macOS**：自动检测 `/Applications/Google Chrome.app` 或 `/Applications/Microsoft Edge.app`
- **Linux**：自动检测 `google-chrome`、`google-chrome-stable` 或 `microsoft-edge`
- 如果本地没有 Chrome/Edge，需手动安装：`playwright install chromium`

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `WECOM_DOC_COOKIE_FILE` | Cookie 文件路径 | `~/.wecom-doc-cookies.json` |

## 支持的文档类型

| URL 类型 | 类型 | 支持 |
|----------|------|------|
| `w3_` / `e2_` | 普通在线文档 | ✅ 完整支持 |
| `e3_` | 在线表格（sheet） | ✅ 支持读取 |
| `e4_` | 智能表格 | ⚠️ 部分支持 |
| 收集表 / 思维导图 | 其他类型 | ❌ 暂不支持 |

## License

MIT
