Skald MCP

🚀 Skald MCP 服務器 🧠

Skald MCP 服務器可讓你與 Skald 知識庫進行交互，添加和更新新知識，並搜索備忘錄。

🚀 快速開始

要使用 Skald MCP 服務器，你需要完成以下步驟：

1. 擁有一個帶有 API 密鑰的 Skald 賬戶。你可以在 platform.useskald.com 獲取。
2. 安裝 Node.js 18.0.0 或更高版本。

✨ 主要特性

Skald MCP 服務器提供了七種強大的工具：

1. skald-chat

你可以用自然語言向 Skald 詢問有關知識庫的問題，並可使用可選過濾器來縮小搜索範圍。

2. skald-search

支持使用多種方法搜索備忘錄，也可以使用可選過濾器：

• 語義搜索 (chunk_vector_search) - 根據含義查找相關內容。
• 標題包含 (title_contains) - 不區分大小寫的子字符串匹配。
• 標題以...開頭 (title_startswith) - 不區分大小寫的前綴匹配。

3. skald-create-memo

創建新的備忘錄，系統會自動對其進行處理、總結、標記、分塊和索引，以便後續搜索。

4. skald-get-memo

通過 UUID 或客戶端引用 ID 檢索備忘錄，可獲取完整內容、摘要、標籤和分塊信息。

5. skald-update-memo

通過 UUID 或客戶端引用 ID 更新現有備忘錄。如果內容更新，系統會重新處理該備忘錄。

6. skald-delete-memo

通過 UUID 或客戶端引用 ID 永久刪除備忘錄及其所有關聯數據。

7. skald-generate

根據提示和從知識庫中檢索到的上下文生成文檔，還可以使用可選的樣式/格式規則和過濾器。

📦 安裝指南

克隆倉庫

git clone https://github.com/skaldlabs/skald-mcp
cd skald-mcp

安裝依賴

npm install

構建項目

npm run build

🛠 配置說明

Cursor 配置

1. 打開 Cursor 設置（在 macOS 上使用 cmd + shift + p，在 Windows 上使用 ctrl + shift + p，然後選擇“Cursor 設置”）。
2. 從左側側邊欄選擇“MCP”，然後點擊“添加新的全局 MCP 服務器”。
3. 添加以下配置：

{
  "mcpServers": {
    "skald": {
      "type": "command",
      "command": "node ABSOLUTE_PATH_TO_PROJECT/build/index.js --key=YOUR_SKALD_API_KEY"
    }
  }
}

請將以下內容進行替換：

• ABSOLUTE_PATH_TO_PROJECT 替換為 skald-mcp 目錄的完整路徑。
• YOUR_SKALD_API_KEY 替換為你的 Skald API 密鑰。

提示：在 Cursor 中右鍵單擊 /build/index.js 並選擇“複製路徑”，即可獲取絕對路徑。

命令行參數：

• --key：你的 Skald API 密鑰（如果不使用環境變量，則為必需項）。

Claude Desktop 配置

1. 打開 Claude Desktop 設置，導航到“開發者”選項卡。
2. 點擊“編輯配置”。
3. 添加以下配置：

{
  "mcpServers": {
    "skald": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_PROJECT/build/index.js"
      ],
      "env": {
        "SKALD_API_KEY": "YOUR_SKALD_API_KEY"
      }
    }
  }
}

請將以下內容進行替換：

• ABSOLUTE_PATH_TO_PROJECT 替換為 skald-mcp 目錄的完整路徑。
• YOUR_SKALD_API_KEY 替換為你的 Skald API 密鑰。

環境變量：

• SKALD_API_KEY：你的 Skald API 密鑰（必需項）。

4. 重啟 Claude Desktop。

💻 使用示例

與知識庫聊天

向 Cursor/Claude 提問："在 Skald 中查詢本地運行我們的 Django 服務器的說明。"

助手將查詢你的 Skald 知識庫並返回答案。

搜索備忘錄

向 Cursor/Claude 提問："在 Skald 中搜索關於我們產品願景的文檔。"

助手將使用 skald-search 工具進行語義搜索，查找相關備忘錄並顯示以下信息：

• 標題
• UUID
• 摘要
• 內容片段
• 相關性得分（用於語義搜索）

如果你詢問“標題中包含產品願景的備忘錄”，代理將選擇其他搜索方法，如 title_contains。

創建新備忘錄

向 Cursor/Claude 提問："為我的端點生成一個 API 參考並上傳到 Skald。"

助手將在你的 Skald 知識庫中創建一個新的備忘錄，該備忘錄將自動處理並可供搜索。

📚 詳細文檔

工具參數說明

skald-chat

skald-search

skald-create-memo

skald-get-memo

skald-update-memo

skald-delete-memo

skald-generate

過濾器對象

過濾器用於 skald-chat、skald-search 和 skald-generate 中，以縮小結果範圍：

過濾器示例：

{
  "field": "source",
  "operator": "eq",
  "value": "notion",
  "filter_type": "native_field"
}

🔧 技術細節

構建項目

npm run build

代碼檢查

npm run lint

修復代碼檢查問題

npm run lint:fix

🛠 故障排除

API 密鑰問題

如果你遇到缺少 API 密鑰的錯誤：

• 對於 Cursor：確保在配置中設置了 --key 參數。
• 對於 Claude Desktop：確保在環境部分設置了 SKALD_API_KEY。

模塊未找到問題

如果你看到“Cannot find module '@skald-labs/skald-node'”錯誤：

npm install
npm run build

連接問題

檢查調試日誌：

• Cursor：在 Cursor 設置中檢查 MCP 服務器日誌。
• Claude Desktop：在 Claude Desktop 開發者設置中檢查日誌。