项目简介

Skald MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在将您的 Skald 知识库能力扩展到大型语言模型（LLM）应用中。它允许 LLM 客户端通过标准化的协议与 Skald 知识库进行交互，实现智能问答、搜索和内容创建等功能。

主要功能点

Skald 聊天: 让大型语言模型直接向您的 Skald 知识库提问，获得基于知识库内容的智能回答。
Skald 搜索: 允许大型语言模型通过语义搜索、标题匹配等多种方式在您的备忘录中查找相关信息。
Skald 创建备忘录: 支持大型语言模型生成并上传新的备忘录到 Skald 知识库，这些内容将自动被处理、总结、标记和索引，以便后续检索。

安装步骤

获取 Skald 账户和 API 密钥: 访问 platform.useskald.com 获取您的 Skald 账户和 API 密钥。
安装 Node.js: 确保您的系统已安装 Node.js 18.0.0 或更高版本。

克隆仓库: 打开终端或命令行工具，执行以下命令克隆项目代码：

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

安装依赖: 在项目目录中执行：
```
npm install
```
构建项目: 构建服务器代码：
```
npm run build
```

服务器配置 (以 Cursor/Claude Desktop 为例)

MCP 服务器需要通过 MCP 客户端（如 Cursor 或 Claude Desktop）进行配置才能使用。以下是配置示例，您需要将 'ABSOLUTE_PATH_TO_PROJECT' 替换为 'skald-mcp' 项目的完整路径，并将 'YOUR_SKALD_API_KEY' 替换为您的 Skald API 密钥。

配置信息示例 (JSON 格式):
```
{
  "mcpServers": {
    "skald": {
      "type": "command",
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_PROJECT/build/index.js",
        "--key=YOUR_SKALD_API_KEY"
      ]
    }
  }
}
```
参数注释:
- '"mcpServers"': 用于定义多个 MCP 服务器的顶层配置对象。
- '"skald"': 您为该 MCP 服务器实例自定义的名称，LLM 客户端将使用此名称引用。
- '"type": "command"': 指示 MCP 客户端通过执行一个命令行命令来启动和连接 MCP 服务器。
- '"command": "node"': 启动 MCP 服务器的执行命令，此处为 Node.js 运行时。
- '"args"': 传递给 'command' 的命令行参数数组。
  - '"ABSOLUTE_PATH_TO_PROJECT/build/index.js"': MCP 服务器的主脚本文件路径。请确保使用您本地 'skald-mcp' 目录的绝对路径，例如 '/Users/youruser/skald-mcp/build/index.js'。
  - '"--key=YOUR_SKALD_API_KEY"': 您的 Skald API 密钥。请将其替换为实际密钥。您也可以选择通过环境变量 'SKALD_API_KEY' 来提供密钥，具体取决于客户端的配置方式。
配置提示:
- 在 Cursor 中，您可以在 "Settings" -> "MCP" 页面添加新的全局 MCP 服务器配置。
- 在 Claude Desktop 中，您可以在 "Settings" -> "Developer" 选项卡中点击 "Edit Config" 来编辑配置。
- 配置完成后，通常需要重启您的 MCP 客户端以使更改生效。

基本使用方法

配置并启动 MCP 客户端后，您可以直接向 LLM 提问，它将自动调用 Skald MCP 服务器提供的工具。

向知识库提问:

问 Cursor/Claude: "检查 Skald，我们如何在本地运行 Django 服务器？"

搜索备忘录:

问 Cursor/Claude: "搜索 Skald 关于产品愿景的文档"

创建新备忘录:

问 Cursor/Claude: "生成我的 API 端点参考并上传到 Skald"

关键词

项目简介

主要功能点

安装步骤

服务器配置 (以 Cursor/Claude Desktop 为例)

基本使用方法

信息