使用说明

项目简介

Folo MCP Server 是一个实现了 Model Context Protocol (MCP) 协议的服务器，旨在作为 LLM 客户端的后端，提供对 Folo RSS 阅读器数据的访问能力。通过此服务器，LLM 可以调用预定义的工具来获取 Folo 中的信息，例如用户的订阅列表、文章条目、未读计数等，从而实现更智能化的信息处理和交互。

主要功能点

数据访问能力: 提供多种工具，允许 LLM 客户端查询和获取 Folo RSS 阅读器中的数据，包括：
- 获取文章条目列表（'entry_list'）
- 获取订阅源列表（'subscription_list'）
- 获取未读条目计数（'unread_count'）
- 获取订阅源信息（'feed_info'）
- 标记条目为已读（'mark_read'）

安装步骤

确保已安装 Node.js 和 npm: Folo MCP Server 基于 Node.js 开发，请确保你的环境中已安装 Node.js 和 npm 包管理器。

安装 folo-mcp: 使用 npm 安装 'folo-mcp' 包。

npm install -g folo-mcp

服务器配置

MCP 客户端需要配置以下信息以连接到 Folo MCP Server。配置信息为 JSON 格式，请复制以下 JSON 代码块到你的 MCP 客户端配置中。

{
  "serverName": "folo-mcp",
  "command": "npx",
  "args": ["folo-mcp", "-y"],
  "description": "Folo MCP Server",
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，设置为 'folo-mcp'。
'command': 启动服务器的命令，设置为 'npx'，表示使用 npm 包执行器。
'args': 命令参数，设置为 '["folo-mcp", "-y"]'。
- '"folo-mcp"': 指定要执行的 npm 包为 'folo-mcp'。
- '"-y"': 传递给 'folo-mcp' 的参数，根据仓库 'README.md'，'-y' 参数可能用于简化启动流程 (具体含义请参考 'folo-mcp' 官方文档或帮助信息)。
'description': 服务器描述，可以设置为 'Folo MCP Server' 或其他描述性文字。
'transport': 传输协议，设置为 'stdio'，表示使用标准输入输出流进行通信。

重要环境变量配置:

Folo MCP Server 依赖 'FOLO_SESSION_TOKEN' 环境变量来访问 Folo API。你需要在运行服务器之前设置此环境变量。

获取 FOLO_SESSION_TOKEN: 你需要从 Folo 获取你的会话令牌 (session token)。通常，这需要在 Folo 网站或应用中登录后获取。
设置环境变量: 根据你的操作系统，设置 'FOLO_SESSION_TOKEN' 环境变量。例如，在 Linux 或 macOS 中，你可以在终端中使用 'export FOLO_SESSION_TOKEN=<你的令牌>' 命令。在 Windows 中，你可以在系统环境变量设置中添加。

基本使用方法

启动 Folo MCP Server: 在配置好 'FOLO_SESSION_TOKEN' 环境变量后，你可以通过 MCP 客户端配置中指定的命令启动服务器。通常，MCP 客户端会自动启动配置的 MCP 服务器。
在 LLM 客户端中使用工具: 一旦服务器成功连接，你就可以在支持 MCP 协议的 LLM 客户端中使用 Folo MCP Server 提供的工具。例如，你可以指示 LLM 使用 'entry_list' 工具来获取最新的文章列表，或使用 'subscription_list' 工具来查看你的订阅源。具体的工具调用方式和参数请参考各个工具的描述信息。

注意: 此 Folo MCP Server 仅提供对 Folo RSS 阅读器数据的访问能力，你需要配合支持 MCP 协议的 LLM 客户端才能使用其功能。

关键词