Feishu Cursor MCP 服务器
使用说明(Markdown格式)
-
项目简介
- 该仓库实现了一个 MCP 服务器(mcp-server.js),为 Cursor CLI 提供“发送文件到飞书”、“列出文件”等工具,便于在 MCP 客户端通过统一的接口调用本地资源与功能。
-
主要功能点
- MCP 服务器:实现 MCP 的核心能力,提供工具注册、工具执行、以及标准化的 JSON-RPC 请求/响应。
- 工具集合:send_file_to_feishu、list_files、record_audio、list_audio_devices 等,支持发送文件、列出目录、录音与设备查询等。
- 与外部系统对接:通过本地 API(例如发送文件接口 /send-file)实现实际操作。
- 支持 STDIO 传输:通过 StdioServerTransport 以标准输入输出方式暴露 MCP 服务。
- 安全与稳定性:实现请求去重、会话管理、错误处理与日志记录。
-
安装步骤
- 确保 npm/node 环境:Node.js 18+。
- 安装依赖并准备环境变量(包括 Feishu App ID/Secret、Cursor 工作目录等)。
- 运行 MCP 服务器:根据项目需求通过命令直接启动,或通过 Cursor CLI 进行配置连接。
- 通过 Cursor CLI 的 MCP 管理工具启用并使用 feishu-file-sender 服务。
-
服务器配置(MCP 客户端所需信息) 下面的配置用于 MCP 客户端与服务器建立连接与调用工具。请仅作为信息参考,客户端无需部署该代码,仅需提供必要的连接参数。 { "name": "feishu-file-sender", "command": "node", "args": ["mcp-server.js"], "env": { "FEISHU_API_PORT": "3456", "FEISHU_API_HOST": "http://localhost" } // 注释:该配置指定 MCP 服务器的名称、启动命令及参数,以及所需的环境变量。MCP 客户端将使用这些信息来启动与管理服务器进程。 }
-
基本使用方法
- 启动与绑定:在 Cursor CLI 中启用 feishu-file-sender MCP 服务后,通过标准的 MCP 调用接口访问以下工具:
- send_file_to_feishu(file_path, message)
- list_files(directory, pattern)
- record_audio(duration, output_path)
- list_audio_devices()
- 使用步骤通常包括:在本地正确配置环境变量,确保本地 API(如 /send-file)可访问,然后通过 MCP 客户端调用上述工具完成需求,如发送文件、列出文件等。
- 启动与绑定:在 Cursor CLI 中启用 feishu-file-sender MCP 服务后,通过标准的 MCP 调用接口访问以下工具: