Meeting BaaS

🚀 會議管理平臺 MCP 集成指南

本指南詳細介紹了會議管理平臺 MCP 的集成和使用方法，涵蓋與 Claude 桌面端的集成、開發環境配置、日誌管理等關鍵功能。

🚀 快速開始

與 Claude 桌面端集成

按照以下步驟將會議管理平臺 MCP 與 Claude 桌面端集成：

1. 打開 Claude 應用。
2. 進入設置界面。
3. 選擇“模型上下文協議”。
4. 添加新的服務器配置：
   • 名稱：輸入“會議管理平臺 MCP”。
   • 類型：選擇“sse”。
   • 服務地址：填寫“http://localhost:7017/mcp”。
   • 可選：添加身份驗證所需的頭信息。

📦 安裝指南

構建項目

在項目根目錄下執行以下命令來構建項目：

npm run build

💻 使用示例

使用 MCP 監控面板測試

使用以下命令運行 MCP 監控面板進行測試：

npm run inspect

開發模式（自動重啟）

若要開啟開發模式（自動重啟），可執行：

npm run dev

日誌管理

服務具備優化的日誌功能，使用以下命令進行日誌管理：

npm run cleanup

此命令的作用如下：

• 清理不必要的日誌文件和緩存數據。
• 過濾掉重複的心跳信息。
• 減少磁盤佔用，同時保留重要日誌信息。
• 維持較小的日誌 footprint 以適應長期運行的服務。

📚 詳細文檔

項目結構

本項目的結構如下：

• src/index.ts：主程序入口。
• src/tools/：工具實現模塊。
• src/resources/：資源定義文件夾。
• src/api/：後端 API 客戶端。
• src/types/：TypeScript 類型定義。
• src/config.ts：服務配置文件。
• src/utils/：實用函數庫。
  • logging.ts：日誌過濾與管理工具。
  • tinyDb.ts：持久化機器人跟蹤數據庫。

身份驗證

服務需要在“x-api-key”頭中提供 API 密鑰進行身份驗證，您可以在配置文件中設置默認密鑰。

此外，許多工具（以“WithCredentials”命名）可以直接接受 API 密鑰作為參數，而無需通過頭信息傳遞。

QR 碼生成器 API 密鑰配置

QR 碼生成工具需要來自 QR Code AI API 的密鑰，以下是幾種提供方式：

1. 直接在提示中輸入：在使用 generateQRCode 工具時，將 API 密鑰直接包含在提示文本中，例如：“為我的網站 https://example.com 生成一個 QR 碼，API 密鑰：qrc_your_key_here”。
2. 作為參數傳遞：在調用 generateQRCode 工具時，提供 apiKey 參數。
3. 環境變量：設置 QRCODE_API_KEY 環境變量。
4. Claude 桌面端配置：將密鑰添加到您的 Claude 桌面端配置文件中：
   • Mac/Linux 系統路徑：~/Library/Application Support/Claude/claude_desktop_config.json。
   • Windows 系統路徑：%APPDATA%\Claude\claude_desktop_config.json。

示例配置如下：

{
  "headers": {
    "x-api-key": "qrc_your_key_here"
  }
}

⚠️ 重要提示

實際使用時，請將 qrc_your_key_here 替換為您自己的 API 密鑰。

📄 許可證

本項目採用 MIT 許可證。