MCP-飞书项目管理工具

MCP-飞书项目管理工具

site icon
2025.04.01 2
Python项目管理团队协作交流协作
MCP-飞书项目管理工具是一个基于MCP(Model Context Protocol)协议的服务器实现,它封装了飞书项目管理的Open API,使AI助手能够与飞书项目管理系统进行交互。该工具允许AI助手获取飞书项目的视图列表、视图详情等信息,帮助用户管理和查询飞书项目中的工作项。
View on GitHub

Overview

基本能力

产品定位

MCP-飞书项目管理工具是一个基于MCP协议的服务器实现,旨在通过AI助手与飞书项目管理系统进行交互,提供项目管理功能。

核心功能

  1. 登录认证:支持登录及认证流程。
  2. 视图功能:获取飞书项目视图列表和视图工作项列表。
  3. 工作项管理:获取工作项详情和创建工作项元数据。
  4. 角色与人员配置:获取流程角色配置详情。

适用场景

  1. 项目管理:帮助用户管理和查询飞书项目中的工作项。
  2. 团队协作:通过AI助手协助团队成员进行项目管理和任务分配。

工具列表

  1. 飞书项目Open API:封装了飞书项目管理的Open API,使AI助手能够与飞书项目管理系统进行交互。
  2. Docker部署:支持通过Docker容器运行MCP飞书项目服务。
  3. Kubernetes部署:支持在Kubernetes集群中部署MCP飞书项目服务。

常见问题解答

  1. 如何配置环境变量:编辑.env文件,填入必要的配置信息。
  2. 如何添加新功能:在fsprojclient.py中添加新的API方法,并在server.py中使用@mcp.tool装饰器注册新的MCP工具。

使用教程

使用依赖

  1. 安装uv:
pip install uv
  1. 创建虚拟环境并安装依赖:
uv venv
uv pip install -e .

安装教程

  1. 克隆本仓库:
git clone https://github.com/yourusername/mcp-feishu-proj.git
cd mcp-feishu-proj
  1. 复制环境变量示例文件并进行配置:
cp .env.example .env
  1. 编辑.env文件,填入必要的配置信息。

调试方式

  1. 使用Docker Compose启动服务:
docker-compose -f docker/docker-compose.yml up -d
  1. 查看日志:
docker-compose -f docker/docker-compose.yml logs -f
  1. 停止服务:
docker-compose -f docker/docker-compose.yml down

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。