Valuepickr MCP

ValuePicker MCP服务器

用于读取和搜索ValuePicker论坛线程的模型上下文协议（MCP）服务器。与Codex CLI和其他MCP客户端配合使用。

特性

• 🔍 以双模式阅读论坛帖子 （默认情况下分块，按需全线程）
• 🔎 搜索论坛 对于主题
• 🎯 在线程内搜索 使用分块或全线程扫描
• ⚡ 配置驱动的速率限制 -并发性、全局延迟和每台主机配额
• 🛡️ 稳健的错误处理 -重试、429回退、URL验证、删除帖子过滤
• 💾 原始页面JSON缓存 -TTL+重新验证时已过时
• 🧵 异步作业模式 -启动/轮询/取消长时间运行的线程作业

快速开始

选项1：使用已部署的服务器（最简单）

服务器已部署并准备好使用：

统一资源定位符: https://valuepickr-mcp.onrender.com

测试一下：

curl https://valuepickr-mcp.onrender.com/

选项2：使用Codex在本地运行

1. 克隆仓库:

git clone https://github.com/YOUR_USERNAME/valuepickr-mcp.git
cd valuepickr-mcp
npm install

1. 添加到Codex:

codex mcp add valuepickr -- node /path/to/valuepickr-mcp/src/index.js

1. 用它:

codex
# Then ask: "Read this thread: https://forum.valuepickr.com/t/ranjans-portfolio/45082"

双模式（推荐）

read_forum_thread 和 search_within_thread 现在支持这两种方式：

• 分块模式（默认）：快速可靠，适用于大螺纹
• 全线程模式：set full_thread=true 在一次通话中获取所有内容

参数

• start_page （数字，默认值 1)
• max_pages （数字，默认值 25，最大值 300)
• full_thread （布尔值，默认值 false)
• include_full_content （布尔值，默认值 true)

连续元数据

工具响应包括：

• has_more=true/false
• next_page= 当剩余更多页面时

示例工作流（大线程）

1. 呼叫 read_forum_thread 随着 start_page=1, max_pages=25
2. 如果 has_more=true，再次致电 start_page=next_page
3. 重复直到 has_more=false

异步作业工具

对于长时间运行的操作，请使用异步作业工具：

• start_read_forum_thread_job
• start_search_within_thread_job
• get_job_status
• get_job_result
• cancel_job

典型流程：

1. 开始工作(start_*_job)和捕获 job_id
2. 投票 get_job_status
3. 使用以下命令获取最终输出 get_job_result
4. 随时通过取消 cancel_job

API文件（SSE上的标准MCP）

此服务器实现 模型上下文协议（MCP） 通过HTTP使用服务器发送事件（SSE）。

端点

GET /sse

建立SSE连接。配置MCP客户端（例如ChatGPT、Claude Desktop）时使用此URL。

POST /messages

处理JSON-RPC消息（由MCP客户端自动处理）。

GET /

健康检查-返回服务器信息。

连接到ChatGPT/Claude桌面

1. 统一资源定位符: https://valuepickr-mcp.onrender.com/sse
2. 运输：SSE（服务器发送事件）

速率限制

服务器使用具有以下功能的速率控制器：

• 全局并发限制
• 全局请求间延迟
• 每台主机每分钟配额
• 429和瞬态故障的自适应重试/回退

部署

部署以渲染（免费）

1. 分叉/克隆此仓库
2. 推送到GitHub
3. 注册 Render.com （无需信用卡）
4. 创建新的Web服务:

- 连接您的GitHub仓库 - 渲染自动检测 render.yaml - 点击“创建Web服务”

1. 完成！ 您的服务器将在 https://your-service-name.onrender.com

环境变量

关键环境变量：

• VP_MAX_CONCURRENCY （默认值： 2)
• VP_GLOBAL_DELAY_MS （默认值： 400)
• VP_HOST_QUOTA_PER_MINUTE （默认值： 120)
• VP_RETRY_ATTEMPTS （默认值： 3)
• VP_RETRY_BASE_MS （默认值： 1000)
• VP_RETRY_MAX_MS （默认值： 10000)
• VP_RETRY_JITTER_MS （默认值： 250)
• VP_CACHE_ENABLED （默认值： true)
• VP_CACHE_TTL_MS （默认值： 300000)
• VP_CACHE_SWR_MS （默认值： 1200000)
• VP_CACHE_MAX_ENTRIES （默认值： 500)
• VP_JOB_MAX_CONCURRENT （默认值： 4)
• VP_JOB_RETENTION_MS （默认值： 1800000)
• VP_JOB_MAX_TOTAL （默认值： 200)
• VP_JOB_CLEANUP_INTERVAL_MS （默认值： 60000)

平台/运行时变量：

• PORT （由渲染自动设置，默认为 3000 当地）
• NODE_ENV (production 在 render.yaml)

发展

在本地运行HTTP服务器：

npm run start:http
# or
node src/server-http.js

运行stdio服务器（用于Codex）：

npm run start:stdio
# or
node src/index.js

运行测试：

npm test
# or
node test-all-features.js
node test-tiered-latency.js
node test-search-within-thread.js

许可证

麻省理工学院

贡献

欢迎拉取请求！请确保在提交之前通过所有测试。