Semantic Search MCP Server

🚀 セマンティック検索 MCP サーバー

mcp-framework を使用して構築された Model Context Protocol (MCP) サーバーで、Claude Desktop のセマンティック検索機能を強化します。

🚀 クイックスタート

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

📚 ドキュメント

詳細な設定手順と使用方法については、以下を参照してください。

• ユーザーガイド - Claude Desktop ユーザー向けの段階的なインストール手順
• 開発者ガイド - 開発者がサーバーを参照または拡張するための技術情報

🔧 プロジェクト構造

semantic-search-mcp-server/
├── src/
│   ├── tools/        # MCP ツールディレクトリ
│   │   └── ExampleTool.ts
│   └── index.ts      # サーバーのエントリーファイル
├── Userguide.md      # Claude Desktop ユーザー向けのインストールガイド
├── DeveloperGuide.md # 開発者向けの技術ガイド
├── package.json
└── tsconfig.json

👨‍💻 開発者向け情報

以下のセクションには、サーバーを変更または拡張したい開発者に役立つ技術情報が含まれています。

コンポーネントの追加

プロジェクトには src/tools/ExampleTool.ts にサンプルツールが付属しています。CLI を使用して、さらに多くのツールを追加できます。

# 新しいツールの追加
mcp add tool my-tool

# 例えば、以下のようなツールを作成できます。
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

💻 ツール開発

サンプルツールの構造は次のとおりです。

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "ツールの機能を説明する";

  schema = {
    message: {
      type: z.string(),
      description: "この入力パラメータの説明",
    },
  };

  async execute(input: MyToolInput) {
    // ここにツールのロジックを記述します。
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

📦 npm への公開

1. package.json を更新します。

   • name が一意で、npm の命名規則に従っていることを確認します。
   • 適切な version を設定します。
   • description、author、license などの情報を追加します。
   • bin が正しいエントリーファイルを指していることを確認します。

2. ローカルでのビルドとテストを行います。

   npm run build
   npm link
   semantic-search-mcp-server  # ローカルで CLI をテストします。
   

3. npm にログインします（必要に応じてアカウントを作成します）。

   npm login
   

4. パッケージを公開します。

   npm publish
   

公開後、ユーザーは Claude Desktop クライアントに追加することができます（以下の説明を参照）。または、npx を使用して実行することもできます。

🤝 Claude Desktop との連携

ローカル開発時

Claude Desktop の設定ファイルに以下の内容を追加します。

MacOS: ~/Library/Application Support/Claude/Settings.json Windows: %APPDATA%/Claude/Settings.json

{
  "semantic-search-mcp-server": {
    "path": "relative/path/to/src",
    "enable": true
  }
}

公開後の使用方法

サーバーを npm に公開した後、ユーザーは Claude Desktop で以下のコマンドを実行することでインストールして使用できます。

claire install semantic-search-mcp-server

🔨 ビルドとテスト

npm run build
npm test

以上の手順に従えば、強力なセマンティック検索 MCP サーバーを簡単に構築、開発、デプロイし、Claude Desktop と統合して使用することができます。このガイドが開発のお手伝いになれば幸いです！