Feishu MCP Proxy
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Feishu MCP Proxyfetch the document with id 12345"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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.
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.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA 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.25 npmMIT
- 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 gradedqualityDmaintenanceOfficial MCP server for Feishu/Lark OpenAPI, enabling AI assistants to interact with Feishu/Lark platform for document processing, messaging, calendar scheduling, and more.10,318 npmMIT
- AlicenseNot gradedqualityBmaintenanceA 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