Folderr MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Folderr API 交互的工具，专门用于管理 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": "您的问题"
     }
   }
   

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

配置

服务器将其配置存储在 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 工具
   • 使用带有来自 Folderr 开发者部分的 API 令牌的 set_api_token 工具
2. 身份验证令牌会自动保存并用于后续请求
3. 所有与助手相关的工具都需要在使用前进行身份验证

错误消息

常见错误消息及其含义：

• "Not logged in"（未登录）：未设置身份验证令牌
• "Login failed"（登录失败）：无效的凭据
• "Failed to list assistants"（无法列出助手）：检索助手列表时出错
• "Failed to ask assistant"（无法询问助手）：向助手发送问题时出错