Folderr

🚀 Folderr MCP 服務器

Folderr MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了與 Folderr API 交互的工具。主要用於管理和通信 Folderr 助手，為用戶提供便捷的操作體驗。

🚀 快速開始

將以下內容添加到您的 MCP 設置中，即可快速啟動 Folderr MCP 服務器：

{
  "mcpServers": {
    "folderr": {
      "command": "npx",
      "args": ["-y", "@folderr/folderr-mcp-server"]
    }
  }
}

✨ 主要特性

認證

支持兩種認證方法，滿足不同場景的使用需求：

1. 使用電子郵件/密碼登錄

{
  "name": "login",
  "arguments": {
    "email": "user@example.com",
    "password": "your-password"
  }
}

2. API 令牌認證

{
  "name": "set_api_token",
  "arguments": {
    "token": "your-api-token"
  }
}

API 令牌可在 Folderr 開發人員部分生成，此方法推薦用於自動化或長時間運行的過程。

助手管理

1. 列出助手

{
  "name": "list_assistants",
  "arguments": {}
}

返回所有可用助手的列表，針對已認證用戶。 2. 詢問助手

{
  "name": "ask_assistant",
  "arguments": {
    "assistant_id": "assistant-id",
    "question": "Your question here"
  }
}

向特定助手發送一個問題並獲取其響應。

📦 安裝指南

構建服務器的步驟如下：

npm install
npm run build

💻 使用示例

基礎用法

在您的 MCP 設置配置中添加以下內容，即可使用 Folderr MCP 服務器：

{
  "mcpServers": {
    "folderr": {
      "command": "node",
      "args": ["/path/to/folderr-server/build/index.js"]
    }
  }
}

高級用法

認證流程

1. 您可以選擇以下兩種認證方式之一：
   • 使用 login 工具進行電子郵件和密碼登錄。
   • 使用 set_api_token 工具進行 API 令牌設置（來自 Folderr 的開發人員部分）。
2. 認證成功後，系統會自動保存認證令牌，並在後續請求中使用。
3. 所有與助手相關的工具在使用前需要進行身份驗證。

📚 詳細文檔

配置

服務器將配置存儲在 config.json 文件中，其中包括：

• Folderr API 的基礎 URL
• 認證令牌（來自登錄或 API 密鑰）

錯誤處理

服務器提供常見場景的詳細錯誤消息：

• 認證失敗
• 無效請求
• API 錯誤
• 網絡問題

錯誤消息

常見錯誤消息及其含義：

• "未登錄"：沒有設置認證令牌
• "登錄失敗"：無效憑證
• "無法列出助手"：檢索助手列表時出錯
• "無法詢問助手"：向助手發送問題時失敗