# Feishu MCP Server

> 让AI读取飞书文档、发送消息、管理日历

## ✨ 特性

- 📄 **文档读取** — 获取文档内容和元信息，搜索文档
- 💬 **消息管理** — 查看群聊消息，发送消息（需关闭只读）
- 📅 **日历查询** — 查看日历和日程
- 📊 **电子表格** — 读取表格数据
- 🔒 **安全优先** — 默认只读，消息发送可限制群聊白名单
- 🇨🇳 **中文优先** — 面向国内飞书用户

## 🚀 快速开始

### 1. 创建飞书应用

1. 访问 [飞书开放平台](https://open.feishu.cn/app)
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 添加权限：文档读取、消息读写、日历读取、表格读取

### 2. 配置MCP

```json
{
  "mcpServers": {
    "feishu": {
      "command": "python",
      "args": ["-m", "feishu_mcp_server"],
      "env": {
        "FEISHU_MCP_APP_ID": "your_app_id",
        "FEISHU_MCP_APP_SECRET": "your_app_secret",
        "FEISHU_MCP_READ_ONLY": "true"
      }
    }
  }
}
```

## 🛠️ 工具列表

| 工具 | 功能 | 安全级别 |
|------|------|---------|
| `get_doc_content` | 获取文档内容 | 🟢 只读 |
| `get_doc_meta` | 获取文档元信息 | 🟢 只读 |
| `search_docs` | 搜索文档 | 🟢 只读 |
| `list_chat_messages` | 获取群聊消息 | 🟢 只读 |
| `send_message` | 发送消息 | 🔴 需关闭只读 |
| `list_calendars` | 获取日历列表 | 🟢 只读 |
| `list_calendar_events` | 获取日程 | 🟢 只读 |
| `list_sheets` | 获取Sheet列表 | 🟢 只读 |
| `get_sheet_values` | 获取表格数据 | 🟢 只读 |

## 📄 License

MIT License