Feishu Defect Tracker

🚀 MCP-FEISHU 文档

MCP-FEISHU 是一款专为 Windsurf IDE 集成打造的微服务控制平面（MCP）服务器。它能从飞书开放 API 获取信息，并将其提供给 IDE 的 MCP 客户端，实现无缝的 API 集成与管理。

🚀 快速开始

MCP-FEISHU 服务器可帮助你轻松集成飞书开放 API 到 Windsurf IDE 中。以下是使用前的准备步骤。

✨ 主要特性

• 连接飞书开放 API 以检索 API 规范。
• 将 API 信息作为 MCP 资源暴露。
• 提供 API 发现和探索工具。
• 支持在 Windsurf IDE 中进行 API 测试与集成。
• 实现 Model Context Protocol (MCP) 协议，达成标准化通信。

📦 安装指南

# 克隆仓库
# git clone https://github.com/yourusername/mcp-feishu.git
# cd mcp-feishu

# 安装依赖
pnpm install

# 构建项目
pnpm run build

💻 使用示例

基础用法

启动服务器

pnpm start

调试模式

npx @modelcontextprotocol/inspector node dist/index.js

与 Windsurf IDE 连接

在你的 Windsurf IDE 设置中添加新的 MCP 服务器配置：

    "mcpServers": {
      "feiShuServer": {
        "command": "node",
        "args": ["/Program Files/project/mcp-feishu/dist/index.js"],
        "env": {
          "APP_ID": "",
          "APP_SECRET": "",
          "TABLE_ID": "",
          "APP_TOKEN": ""
        }
      }
    }

高级用法

开发模式

# 以开发模式运行，支持热重载
npm run dev

📚 详细文档

API 资源

MCP-FEISHU 服务器提供以下资源：

• api://projects - 列出所有 API 项目。
• api://projects/{projectId} - 获取特定项目的详细信息。
• api://projects/{projectId}/apis - 列出项目中的所有 API。
• api://projects/{projectId}/apis/{apiId} - 获取特定 API 的详细信息。

工具功能

服务器提供以下工具：

• get_defect_link - 获取特定缺陷的链接。
• get_recently_updated_defect_list - 获取最近更新的缺陷列表。

📄 许可证

本项目采用 MIT 许可证。