Skald MCP

🚀 Skald MCP Server 🧠

Skaldの知識ベースと会話し、新しい知識を追加・更新し、メモを検索することができます。

✨ 主な機能

Skald MCPサーバーは7つの強力なツールを提供します。

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

プロンプトと知識ベースから取得したコンテキストに基づいてドキュメントを生成し、必要に応じてスタイル/形式のルールとフィルターを使用できます。

📦 インストール

前提条件

1. APIキーを持つSkaldアカウント。platform.useskald.com で取得できます。
2. Node.js 18.0.0以上

インストール手順

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

📚 ドキュメント

Cursorの設定

1. Cursorの設定を開きます（macOSではcmd+shift+p、Windowsではctrl+shift+p → "Cursor Settings"）。
2. 左サイドバーから "MCP" を選択し、"Add new global MCP server" をクリックします。
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 を右クリックし、"Copy Path" を選択すると、絶対パスを取得できます。

コマンドライン引数:

• --key: あなたのSkald APIキー（環境変数を使用しない場合に必須）

Claude Desktopの設定

1. Claude Desktopの設定を開き、"Developer" タブに移動します。
2. "Edit Config" をクリックします。
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
• 要約
• 内容のスニペット
• 関連度スコア（セマンティック検索の場合）

もし "タイトルにProduct Visionが含まれるメモ" を要求した場合、エージェントは 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

Filter Object

フィルターは 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の開発者設定でログを確認してください。