MCP Server Feishu

🚀 mcp-server-feishu 飛書 MCP 服務器

本項目是一個基於 TypeScript 的 MCP 服務器，實現了簡單的筆記系統，可將筆記記錄到飛書。它清晰地演示了核心的 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。