MCP Node

🚀 模型上下文協議（MCP）Node.js工具

本項目是名為“模型上下文協議”（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目錄下找到構建文件。

✨ 主要特性

• 提供與Algolia服務交互的MCP接口。
• 支持通過命令行啟動服務器和管理認證狀態。
• 可集成到Claude Desktop以增強功能擴展。

📦 安裝指南

全局安裝

npm install -g algolia-mcp

本地開發環境搭建

1. 克隆倉庫並進入目錄：

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

2. 安裝依賴：

   npm install
   

3. 啟動開發服務器：

   npm run start
   

💻 使用示例

基礎用法

示例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無法訪問工具：
   • 檢查並確認MCP配置在Claude Desktop設置中正確無誤。

貢獻指南

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提供，僅供參考用途。請勿用於生產環境，並確保在充分測試後謹慎使用。