MCP Node

🚀 モデルコンテキストプロトコル（MCP）

このプロジェクトは、「モデルコンテキストプロトコル」（Model Context Protocol、略称MCP）というNode.jsツールです。Claude Desktopと統合し、Algoliaサービスとのやり取り機能を提供します。使用条件については、LICENSEファイルを参照してください。

🚀 クイックスタート

プロジェクトの依存関係

• Node.js 22以上
• npm

📦 インストール

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/algolia/mcp-node
   cd mcp-node
   npm install
   

2. プロジェクトをビルドします：

   npm run build -- --outfile dist/algolia-mcp
   

3. インストールが完了すると、dist/algolia-mcpディレクトリにビルドファイルが生成されます。

グローバルインストール

npm install -g algolia-mcp

ローカル開発環境のセットアップ

1. リポジトリをクローンしてディレクトリに移動します：

   git clone https://github.com/algolia/mcp-node
   cd mcp-node
   

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

   npm install
   

3. 開発サーバーを起動します：

   npm run start
   

✨ 主な機能

• Algoliaサービスとのやり取りを行うMCPインターフェースを提供します。
• コマンドラインでサーバーを起動し、認証状態を管理できます。
• Claude Desktopに統合して機能拡張を強化します。

💻 使用例

基本的な使用法

例1：MCPサーバーの起動

npm run start-server -- --allow-tools listIndices,getSettings,searchSingleIndex

例2：認証

npm run authenticate

例3：ログの確認

ログファイルの保存パスは以下の通りです：

• macOS: ~/Library/Logs/algolia-mcp/
• Windows: %APPDATA%\algolia-mcp\logs\
• Linux: ~/.config/algolia-mcp/logs/

📚 ドキュメント

開発設定

プロジェクトのルートディレクトリにpackage.jsonを作成または編集し、以下の内容を追加します：

{
  "scripts": {
    "start": "node src/app.ts"
  }
}

トラブルシューティング

一般的な問題

1. 「アプリケーションが応答しない」エラー：

   • macOSでは、quarantined属性を削除してください：

     xattr -d com.apple Quarternary-attribute /path/to/algolia-mcp
     

2. 認証失敗：

   • 一度ログアウトしてから再度認証を試みてください。

3. Claudeがツールにアクセスできない：

   • Claude Desktopの設定でMCPの設定が正しいことを確認してください。

貢献ガイド

1. 機能ブランチを作成します：

   git checkout -b feature/amazing-feature
   

2. 変更をコミットします：

   git commit -m '添加 awesome 功能'
   

3. リモートリポジトリにプッシュします：

   git push origin feature/amazing-feature
   

4. プルリクエストを作成します。

📄 ライセンス

Algolia Node.js MCPはMITライセンスに従います。詳細な条項はLICENSEファイルを参照してください。

⚠️ 重要提示

このコード例はAlgoliaが提供しているもので、参考用です。本番環境での使用は避け、十分にテストしてから慎重に使用してください。