mcpField
F
forumport

forumport

本地服务
github.com/CloudCorpRecords社交媒体02 周前更新
代码仓库

关于 forumport

forumport 将 Reddit API 的一部分封装为工具，可浏览版块、帖子、评论和用户，也可提交帖子与评论。它供 MCP 客户端和命令行使用，通过提供的 Reddit 访问令牌认证，不包含 OAuth 应用授权流程。

主要功能

  1. 01浏览版块热门、最新和顶帖
  2. 02搜索帖子与版块
  3. 03获取帖子、评论和用户数据
  4. 04提交帖子并创建评论
  5. 05Bearer 令牌 API 认证

适用场景

  1. 01为 Agent 获取版块帖子
  2. 02查找 Reddit 帖子与评论
  3. 03通过工具提交帖子或评论

MCP 相关

向 MCP 客户端提供 12 个 Reddit 工具，用于版块、帖子、评论和用户操作。它以 stdio MCP 服务运行，API 请求需要 `REDDIT_ACCESS_TOKEN`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-forumport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/forumport"
      ]
    }
  }
}
启动命令npx -y @reneturcios/forumport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/forumport0.1.0
ocighcr.io/cloudcorprecords/forumport:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
limitnumber否要返回的帖子数量上限。
subredditstring是subreddit 名称，不含 r/ 前缀。

详细介绍

forumport

将 Reddit 封装为 MCP 工具，并与 Reddit API 通信。forumport 是 Reddit MCP 服务核心功能的 洁净室重建版本， 采用了新名称：全新代码，不复制品牌。

认证模式——仅使用 TOKEN 环境变量：工具直接读取 REDDIT_ACCESS_TOKEN， 并将其作为 Authorization: Bearer 发送至 https://oauth.reddit.com。不会重现 OAuth 应用流程 （REDDIT_CLIENT_ID/REDDIT_CLIENT_SECRET + script/password grant + refresh）。

工具（核心子集，共 12 个）

get_subreddit_hot、get_subreddit_new、get_subreddit_top、 search_posts、get_post、get_post_comments、 get_subreddit_about、search_subreddits、get_user_profile、 get_user_posts、submit_post、create_comment。

此子集中不包括：OAuth 应用授权／令牌／刷新流程、 私信和收件箱、版务工具、Wiki、Flair 管理、奖励／Gold、多版块／合集、用户 设置／偏好、版块设置／管理、直播帖、 媒体上传、投票，以及除提交帖文／评论之外的保存／隐藏／举报操作、 账户创建。

设置

创建 Reddit 访问令牌并设置：

export REDDIT_ACCESS_TOKEN=...

也可选择使用 REDDIT_API_BASE_URL 覆盖 API 基础地址 （默认值为 https://oauth.reddit.com），并使用 REDDIT_USER_AGENT 覆盖 User-Agent （默认值为 forumport/0.1.0 (MCP rebuild)）。 每个请求都会携带 Bearer 令牌标头和 User-Agent 标头。未设置令牌时，每次工具调用都会失败，并指出缺失的变量。

CLI

npx @reneturcios/forumport get_subreddit_hot '{"subreddit":"node","limit":10}'
npx @reneturcios/forumport mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "forumport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/forumport", "mcp"],
      "env": { "REDDIT_ACCESS_TOKEN": "..." }
    }
  }
}

Docker

docker run -i -e REDDIT_ACCESS_TOKEN ghcr.io/cloudcorprecords/forumport

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。