AI导哈

知识库管理服务

Skald MCP服务器提供知识库聊天、搜索、创建、更新、删除和生成文档的功能，适用于个人和企业知识管理。

  • by skaldlabs
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 skaldlabs/skald-mcp

使用说明

Skald MCP服务器🧠

与您的Skald知识库聊天，添加和更新新知识，并搜索备忘录。

特性

Skald MCP服务器提供七个强大的工具：

1. skald聊天

使用可选过滤器缩小搜索范围，用自然语言向Skald询问有关您的知识库的问题。

2. skald搜索

使用多种方法和可选过滤器搜索您的备忘录：

  • 语义搜索 (chunk_vector_search)-按含义查找相关内容
  • 标题包含 (title_contains)-不区分大小写的子字符串匹配
  • 标题以开头 (title_startswith)-不区分大小写的前缀匹配

3. skald创建备忘录

创建自动处理、汇总、标记、分块和索引以供搜索的新备忘录。

4. 斯卡尔德得到备忘录

通过UUID或客户端参考ID检索包含完整内容、摘要、标签和块的备忘录。

5. skald更新备忘录

通过UUID或客户端引用ID更新现有备忘录。如果内容被更新，备忘录将被重新处理。

6. skald删除备忘录

通过UUID或客户端引用ID以及所有相关数据永久删除备忘录。

7. skald生成

使用可选的样式/格式规则和过滤器，根据提示和从知识库中检索到的上下文生成文档。

设置

先决条件

  1. 具有API密钥的Skald帐户。获取你的 platform.useskald.com
  2. Node.js 18.0.0或更高版本

安装

  1. 克隆此存储库：
git clone https://github.com/skaldlabs/skald-mcp
cd skald-mcp
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

配置

光标

  1. 打开光标设置(cmd+shift+p 在macOS或 ctrl+shift+p 在Windows上→ “光标设置”）

  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密钥

提示： 右键单击 /build/index.js 在游标中，选择“复制路径”以获取绝对路径。

命令行参数：

  • --key：您的Skald API密钥（如果不使用环境变量，则为必需项）

Claude桌面版

  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密钥（必需）
  1. 重新启动克劳德桌面

使用示例

与您的知识库聊天

Ask Cursor/Claude: "Check Skald for what are the instructions for running our Django server locally."

助理将查询您的Skald知识库并返回答案。

搜索备忘录

Ask Cursor/Claude: "Search Skald for the docs about our product vision"

助理将使用 skald-search 具有语义搜索功能的工具，用于查找相关备忘录并显示：

  • 标题
  • 通用唯一标识符
  • 总结
  • 内容片段
  • 相关性得分（用于语义搜索）

如果你要求“标题中包含产品愿景的备忘录”，代理人会选择另一种搜索方法，例如 title_contains.

创建新备忘录

Ask Cursor/Claude: "Generate an API reference for my endpoints and upload it to Skald"

助理将在您的Skald知识库中创建一个新的备忘录，该备忘录将被自动处理并可搜索。

刀具参数

skald聊天

参数 类型 必填 说明
query string 是 要问你的知识库的问题
project_id string 否 项目UUID（使用令牌身份验证时需要）
filters 筛选器[] 否 用于缩小搜索范围的可选筛选器

skald搜索

参数 类型 必填 说明
query string 是 搜索查询
search_method enum 是 以下之一： chunk_vector_search, title_contains, title_startswith
limit number 否 返回的最大结果数（1-50，默认值10）
filters 筛选器[] 否 筛选结果的可选筛选器

skald创建备忘录

参数 类型 必填 说明
title string 是 备忘录的标题（最多255个字符）
content string 是 备忘录的全部内容
project_id string 否 项目UUID（使用令牌身份验证时需要）
metadata object 否 自定义JSON元数据
reference_id string 否 与文档匹配的外部引用ID
tags string[] 否 分类标签
source string 否 内容来源（对集成有用）

斯卡尔德得到备忘录

参数 类型 必填 说明
memo_id string 是 备忘录UUID或客户端引用ID
id_type enum 否 标识符类型： memo_uuid （默认）或 reference_id

skald更新备忘录

参数 类型 必填 说明
memo_id string 是 备忘录UUID或客户端引用ID
id_type enum 否 标识符类型： memo_uuid （默认）或 reference_id
title string 否 备忘录的新标题
content string 否 备忘录的新内容
metadata object 否 新元数据
client_reference_id string 否 新客户端引用ID
source string 否 新源
expiration_date string 否 新的到期日期

skald删除备忘录

参数 类型 必填 说明
memo_id string 是 备忘录UUID或客户端引用ID
id_type enum 否 标识符类型： memo_uuid （默认）或 reference_id

skald生成

参数 类型 必填 说明
prompt string 是 文档生成提示
rules string 否 可选样式/格式规则
filters 筛选器[] 否 可选筛选器，用于控制哪些备忘录用作上下文

筛选对象

过滤器用于 skald-chat, skald-search，以及 skald-generate 缩小结果范围：

字段 类型 必填 描述
field string 是 要筛选的字段
operator enum 是 以下之一： eq, neq, contains, startswith, endswith, in, not_in
value string或string[] 是 要筛选的值
filter_type enum 是 native_field （例如，来源、标签）或 custom_metadata

过滤器示例：

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

发展

构建

npm run build

棉绒

npm run lint

修复掉毛问题

npm run lint:fix

故障排除

API关键问题

如果您收到有关缺少API密钥的错误：

  • 对于游标：确保 --key 参数已在配置中设置
  • 对于Claude Desktop：确保 SKALD_API_KEY 在env部分中设置

未找到模块

如果您看到“找不到模块'@skald-labs/skald-node'”：

npm install
npm run build

连接问题

检查调试日志：

  • 游标：检查游标设置中的MCP服务器日志
  • Claude Desktop：检查Claude Desktop开发人员设置中的日志

相关 MCP