Folderr MCP 服务器

模型上下文协议 (MCP) 服务器提供与 Folderr 的 API 交互的工具，专门用于管理和与 Folderr 助手通信。

安装

添加到您的 MCP 设置

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

Related MCP server: Filesystem 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"
     }
   }

   向特定助手发送问题并接收他们的答复。

配置

服务器将其配置存储在config.json文件中，其中包括：

• Folderr API 的基本 URL

• 身份验证令牌（来自登录或 API 密钥）

错误处理

服务器提供了常见场景的详细错误信息：

• 身份验证失败

• 无效请求

• API 错误

• 网络问题

发展

构建服务器：

npm install
npm run build

在 MCP 设置中的使用

将以下内容添加到您的 MCP 设置配置中：

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

身份验证流程

1. 任何一个：

   • 使用电子邮件和密码login工具

   • 使用set_api_token工具和来自 Folderr 开发者部分的 API 令牌

2. 身份验证令牌会自动保存并用于后续请求

3. 所有与助手相关的工具在使用前都需要身份验证

错误消息

常见错误信息及其含义：

• “未登录”：未设置身份验证令牌

• “登录失败”：凭证无效

• “无法列出助手”：检索助手列表时出错

• “无法询问助手”：向助手发送问题时出错