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生成
使用可选的样式/格式规则和过滤器，根据提示和从知识库中检索到的上下文生成文档。
设置
先决条件
- 具有API密钥的Skald帐户。获取你的 platform.useskald.com
- Node.js 18.0.0或更高版本
安装
- 克隆此存储库：
git clone https://github.com/skaldlabs/skald-mcp
cd skald-mcp- 安装依赖项：
npm install- 构建项目：
npm run build配置
光标
- 打开光标设置(
cmd+shift+p在macOS或ctrl+shift+p在Windows上→ “光标设置”）
- 从左侧边栏中选择“MCP”，然后单击“添加新的全局MCP服务器”
- 添加以下配置：
{
"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桌面版
- 打开Claude Desktop设置并导航到“开发人员”选项卡
- 点击“编辑配置”
- 添加以下配置：
{
"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密钥（必需）
- 重新启动克劳德桌面
使用示例
与您的知识库聊天
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开发人员设置中的日志