AI导哈

Folderr助手协议服务器

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

  • by folderr-tech
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 folderr-tech/folderr-mcp-server

使用说明

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": "Your question here"
  }
}

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

配置

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

  • 文件夹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. 所有与助手相关的工具在使用前都需要身份验证

错误消息

常见错误信息及其含义：

  • “未登录”：未设置身份验证令牌
  • “登录失败”：凭据无效
  • “列出助手失败”：检索助手列表时出错
  • “询问助手失败”：向助手发送问题时出错

相关 MCP