Feishu MCP Proxy
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Feishu MCP Proxy
飞书 MCP 服务的本地反向代理,自动管理 tenant_access_token 的获取和刷新,让你的 AI Agent 无需关心 token 过期问题。
架构
Claude Code / AI Agent
│
│ POST http://localhost:9099/mcp
▼
┌─────────────────────────┐
│ Feishu MCP Proxy │
│ - 自动获取 TAT │
│ - 后台定时刷新 │
│ - 透明转发请求 │
└─────────────────────────┘
│
│ POST https://mcp.feishu.cn/mcp
│ + X-Lark-MCP-TAT: t-xxx
▼
Feishu MCP ServerRelated MCP server: reasonix-feishu-mcp
前置条件
Python 3.10+
在飞书开放平台创建自建应用,获取 App ID 和 App Secret
为应用申请所需的 API 权限(如
docx:document:readonly,docx:document:create等)
安装
git clone https://github.com/Tim-Siu/feishu-mcp-proxy.git
cd feishu-mcp-proxy
pip install .或开发模式安装:
pip install -e .配置
cp .env.example .env编辑 .env 文件:
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx可选配置
环境变量 | 说明 | 默认值 |
| 允许的工具列表(逗号分隔) | 全部工具 |
| 监听地址 |
|
| 监听端口 |
|
| 日志级别 |
|
启动
python -m feishu_mcp_proxy或使用安装后的命令:
feishu-mcp-proxy启动后可通过 /health 端点检查状态:
curl http://localhost:9099/healthClaude Code 集成
一键配置
claude mcp add feishu --transport http http://localhost:9099/mcp这会自动将飞书 MCP 添加到你的 Claude Code 配置中。
手动配置
也可以在项目目录下创建 .mcp.json:
{
"mcpServers": {
"feishu": {
"type": "streamableHttp",
"url": "http://localhost:9099/mcp"
}
}
}启动 proxy 后,Claude Code 即可直接使用飞书 MCP 工具(如 fetch-doc, create-doc, search-doc 等),无需手动管理 token。
支持的 MCP 工具
工具 | 说明 |
| 搜索云文档 |
| 创建云文档 |
| 查看云文档内容 |
| 更新云文档 |
| 列出知识空间下的文档 |
| 查看文档评论 |
| 添加文档评论 |
| 搜索用户 |
| 获取用户信息 |
| 获取文件内容 |
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceA zero-configuration MCP server enabling AI assistants to interact with Feishu (Lark) workspace through OAuth authentication, supporting document operations, content creation, and advanced file management.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for Feishu/Lark API integration, enabling AI agents to send messages, manage groups, create and edit documents and spreadsheets, and search knowledge bases.MIT
- AlicenseNot gradedqualityDmaintenanceA Cloudflare Workers-based remote MCP gateway that securely bridges Feishu official MCP to MCP clients like ChatGPT, using OAuth-authorized user tokens for accessing and managing personal Feishu documents.1Apache 2.0
- AlicenseNot gradedqualityFmaintenanceMCP server for operating Feishu Docs, folders, and attachments, and sending notifications via custom bot webhooks. Enables AI assistants to automate document workflows in Feishu.1MIT