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 开发者设置中检查日志。