Jiang Feishu Mcp

by upJiang

434 downloads
Not rated
GitHub

Description

# 飞书文档 MCP 一个用于连接飞书文档的Model Context Protocol (MCP) 服务,可以在Cursor等AI客户端中直接访问飞书文档空间和文档列表。 ## 功能特点 - 支持获取飞书全部云文档空间列表 - 支持获取指定空间的文档列表 - 通过MCP协议与AI客户端无缝连接 ## 什么是MCP MCP (Model Context Protocol) 是一个将自定义服务与各种LLM客户端(如Claude、Cursor)无缝连接的协议。它允许AI直接调用和使用我们的服务功能。 - **MCP客户端**:AI应用程序(如Claude…

About

# 飞书文档 MCP 一个用于连接飞书文档的Model Context Protocol (MCP) 服务,可以在Cursor等AI客户端中直接访问飞书文档空间和文档列表。 ## 功能特点 - 支持获取飞书全部云文档空间列表 - 支持获取指定空间的文档列表 - 通过MCP协议与AI客户端无缝连接 ## 什么是MCP MCP (Model Context Protocol) 是一个将自定义服务与各种LLM客户端(如Claude、Cursor)无缝连接的协议。它允许AI直接调用和使用我们的服务功能。 - **MCP客户端**:AI应用程序(如Claude Desktop或Cursor),负责发起请求并与服务器通信 -…

Details

Author
upJiang
Downloads
434
Categories
Communication

- Retrieve a list of all Feishu cloud document spaces
- List documents within a specific space
- Connects to AI clients via the MCP protocol
- Simple setup with environment variable configuration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Jiang Feishu Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install from source using git clone, pnpm install, and pnpm start. Configure a .env file with your Feishu app credentials (App ID and App Secret). The server runs on port 7777 by default. In Cursor, add a new MCP Server with URL http://localhost:7777/mcp. Then use the tools list-spaces and list-documents.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "jiang feishu mcp": {
            "jiang-feishu-mcp": {
                "type": "http",
                "url": "http://localhost:7777/mcp"
            }
        }
    }
}

McpServers

{
    "jiang-feishu-mcp": {
        "type": "http",
        "url": "http://localhost:7777/mcp"
    }
}

飞书文档 MCP

一个用于连接飞书文档的Model Context Protocol (MCP) 服务,可以在Cursor等AI客户端中直接访问飞书文档空间和文档列表。

功能特点

- 支持获取飞书全部云文档空间列表 - 支持获取指定空间的文档列表 - 通过MCP协议与AI客户端无缝连接

什么是MCP

MCP (Model Context Protocol) 是一个将自定义服务与各种LLM客户端(如Claude、Cursor)无缝连接的协议。它允许AI直接调用和使用我们的服务功能。 - MCP客户端:AI应用程序(如Claude Desktop或Cursor),负责发起请求并与服务器通信 - MCP服务器:本项目,暴露飞书文档功能,通过标准化协议与客户端交互

安装与运行

从源码安装

``bash

克隆项目

git clone https://github.com/yourusername/jiang-feishu-mcp.git cd jiang-feishu-mcp

安装依赖

pnpm install

启动服务

pnpm start
` 服务器将在本地7777端口启动。

配置

在使用前,您需要创建一个
.env文件配置飞书应用凭证: `bash

复制示例配置文件

cp .env.example .env
` 然后编辑.env文件,填入您的飞书应用凭证: ` FEISHU_APP_ID=your_app_id_here FEISHU_APP_SECRET=your_app_secret_here

可选:设置端口号 (默认为7777)

PORT=7777

可选:设置文档保存路径 (默认为 ./docs)

DOCS_SAVE_PATH=./docs
` 获取飞书应用凭证的步骤: 1. 访问飞书开放平台并登录 2. 创建一个企业自建应用 3. 在应用详情页获取App ID和App Secret 4. 确保开启了云文档相关权限(文档、表格、云空间读取权限)

在Cursor中使用

1. 启动服务器:
pnpm start 2. 打开Cursor的设置页面 3. 找到"Model Context Protocol"设置 4. 添加新的MCP Server,URL填入:http://localhost:7777/mcp 5. 保存设置 现在,您可以在Cursor中使用以下工具: - list-spaces: 列出所有文档空间 - list-documents: 列出所有或指定空间的文档

示例用法

在Cursor中,您可以这样使用MCP工具:
` 请列出我所有的飞书文档空间 ` ` 请列出空间ID为"XYZ123"中的所有文档 ``

技术架构

该项目使用了以下技术: - Node.js 和 TypeScript:开发环境 - MCP SDK:实现MCP服务器接口 - Express:提供HTTP服务 - 飞书开放API:访问飞书文档内容

注意事项

- 应用需要有访问飞书云文档的权限

许可证

MIT
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.