JinDaGe - mcp-server-feishu MCP Details

article

README

🚀 mcp-server-feishu 飞书 MCP 服务器

本项目是一个基于 TypeScript 的 MCP 服务器，可实现将笔记记录到飞书的功能，为用户打造了一个简单实用的笔记系统。它充分展示了核心的 MCP 概念，助力用户高效管理笔记。

🚀 快速开始

本项目是基于 TypeScript 实现的 MCP 服务器，构建了一个简易的笔记系统。其核心功能包括对带有 URI 和元数据的文本笔记资源的管理、创建新笔记以及生成笔记摘要等。

✨ 主要特性

资源

可列出并访问带有 note:// URI 的笔记。
每篇笔记包含标题、内容和元数据。
采用纯文本 MIME 类型，便于进行简单的内容访问。

工具

create_note：用于创建新的文本笔记。
- 需将标题和内容作为必填参数传入。
- 会将笔记存储在服务器状态中。

提示

summarize_notes：生成所有已存储笔记的摘要。
- 会将所有笔记内容作为嵌入式资源包含在内。
- 返回结构化提示，供大语言模型（LLM）进行总结。

📦 安装指南

开发环境依赖安装

安装项目所需的依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式

使用自动重建进行开发：

npm run watch

与 Claude Desktop 集成配置

若要与 Claude Desktop 一起使用，请添加以下配置：

在 MacOS 上：配置文件路径为 ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：配置文件路径为 %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-feishu": {
      "command": "node",
      "args": ["/path/to/mcp-server-feishu/build/index.js"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxx",
        "FEISHU_APP_SECRET": "3uKtbKpUmEu0xxxu",
        "FEISHU_APP_TOKEN": "JjT1btzyza5yxxxx",
        "FEISHU_TABLE_ID": "tbls1O9t1Qxxxx"
      }
    }
  }
}

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能存在一定挑战。我们推荐使用 MCP Inspector 这个包装脚本进行调试：

npm run inspector

Inspector 会提供一个可在浏览器中访问调试工具的 URL。

mcp-server-feishu