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在本地运行
- 克隆仓库:
git clone https://github.com/YOUR_USERNAME/valuepickr-mcp.git
cd valuepickr-mcp
npm install- 添加到Codex:
codex mcp add valuepickr -- node /path/to/valuepickr-mcp/src/index.js- 用它:
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/falsenext_page=当剩余更多页面时
示例工作流（大线程）
- 呼叫
read_forum_thread随着start_page=1,max_pages=25 - 如果
has_more=true，再次致电start_page=next_page - 重复直到
has_more=false
异步作业工具
对于长时间运行的操作，请使用异步作业工具：
start_read_forum_thread_jobstart_search_within_thread_jobget_job_statusget_job_resultcancel_job
典型流程：
- 开始工作(
start_*_job)和捕获job_id - 投票
get_job_status - 使用以下命令获取最终输出
get_job_result - 随时通过取消
cancel_job
API文件（SSE上的标准MCP）
此服务器实现 模型上下文协议（MCP） 通过HTTP使用服务器发送事件（SSE）。
端点
GET /sse
建立SSE连接。配置MCP客户端（例如ChatGPT、Claude Desktop）时使用此URL。
POST /messages
处理JSON-RPC消息（由MCP客户端自动处理）。
GET /
健康检查-返回服务器信息。
连接到ChatGPT/Claude桌面
- 统一资源定位符:
https://valuepickr-mcp.onrender.com/sse - 运输：SSE（服务器发送事件）
速率限制
服务器使用具有以下功能的速率控制器：
- 全局并发限制
- 全局请求间延迟
- 每台主机每分钟配额
- 429和瞬态故障的自适应重试/回退
部署
部署以渲染（免费）
- 分叉/克隆此仓库
- 推送到GitHub
- 注册 Render.com （无需信用卡）
- 创建新的Web服务:
- 连接您的GitHub仓库 - 渲染自动检测 render.yaml - 点击“创建Web服务”
- 完成！ 您的服务器将在
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许可证
麻省理工学院
贡献
欢迎拉取请求！请确保在提交之前通过所有测试。