freshcontext mcp
我请克劳德帮我找份工作。它给了我一份职位空缺清单。我申请了其中的三个。两个已经不存在了。其中一家已经关闭了两年。
克劳德不知道。它以同样的信心呈现了一切。
这就是freshcontext修复的问题。
](https://www.npmjs.com/package/freshcontext-mcp)  
现场演示: freshcontext-mcp.gimmanuel73.workers.dev/demo --相同的模型,相同的查询,两个完全不同的答案。只有时间层发生了变化。
______________________________________________________________________
问题
大型语言模型从语义上检索web数据。余弦相似度可以找到与查询最匹配的文档,但余弦不知道文档是什么时候编写的。
因此,2022年的博客文章和2026年的论文得分几乎相同。该模型获得了一个充满过时文档的上下文窗口,并忠实地总结了2022年对2026年问题的建议。
这不是幻觉。这是对损坏检索的正确总结。
大多数RAG管道在语义上正确地排列上下文,但在时间上不正确。
______________________________________________________________________
层
FreshContext是一个 检索系统的时间校正层.在上下文到达LLM之前应用一个数学校正:
R_t = R_0 · e^(−λt)R_0--基础语义相关性(无论检索器已经给你什么)λ--源特定衰变常数(HN≈14h半衰期,博客≈29d,学术论文≈1.6y)t--自发布以来已过去的小时数R_t--查询时的衰减调整相关性
这就是全部解决方案。没有模型交换。无需重新嵌入。无需重新索引。该层会下降到您已经拥有的任何检索管道上。
层就是产品。 此仓库附带的21个工具是演示兼容性的参考实现——很有用,但很普通。DAR引擎、新鲜度包络和FreshContext规范是护城河。
______________________________________________________________________
标准
每个与FreshContext兼容的响应都将内容封装在一个结构化的信封中:
[FRESHCONTEXT]
Source: https://github.com/owner/repo
Published: 2024-11-03
Retrieved: 2026-03-05T09:19:00Z
Confidence: high
---
... content ...
[/FRESHCONTEXT]当 它被取回了。 哪里 它来自。 多么自信 我们确认日期是准确的。
FreshContext规范v1.1在MIT许可下作为开放标准发布。任何将检索到的数据包装在此信封中的工具、代理或系统都与FreshContext兼容。 → 阅读规格 · 阅读方法
______________________________________________________________________
情报馈送
除了每次调用的包络之外,生产级FreshContext部署还公开了一个连续的、经过衰减评分和重复数据消除的提要:
GET /v1/intel/feed/:profile_id?limit=20&min_rt=0每个信号都印有 base_score, rt_score, entropy_level (低/稳定/高), ha_pri_sig (SHA-256来源), semantic_fingerprint (交叉适配器已消除),以及 published_at已准备好直接使用LLM或试剂,无需合成。
生产终点: https://freshcontext-mcp.gimmanuel73.workers.dev
______________________________________________________________________
参考适配器
该仓库提供了21个工具,演示如何使任何数据源与FreshContext兼容。作为插入式工具很有用,但价值在于它们之上的层。
智能
| 适配器 | 它返回什么 |
|---|---|
extract_github | README、stars、fork、语言、主题、上次提交 |
extract_hackernews | 带有分数和时间戳的热门故事或搜索结果 |
extract_scholar | 研究论文——标题、作者、年份、摘要 |
extract_arxiv | arXiv文件通过官方API |
extract_reddit | 来自任何子版块的帖子和社区情绪 |
竞争性研究
| 适配器 | 它返回什么 |
|---|---|
extract_yc | YC公司按关键字列出 |
extract_producthunt | 按主题列出的最新发布 |
search_repos | GitHub repos按活动信号星级排名 |
package_trends | npm和PyPI元数据——版本历史、发布节奏 |
市场数据
| 适配器 | 它返回什么 |
|---|---|
extract_finance | 没有关键的Stooq报价数据——收盘价、OHLC、交易量、报价时间戳、来源。最多5个股票。 |
search_jobs | 远程职位列表来自Remative、RemoteOK、HN“谁在招聘” |
复合材料——多个来源,一个电话
| 适配器 | 来源 | 用途 |
|---|---|---|
extract_landscape | 6 | YC+GitHub+HN+Reddit+产品搜索+npm并行 |
extract_idea_landscape | 6 | HN+YC+GitHub+Jobs+npm+Product Hunt——完整创意验证 |
extract_gov_landscape | 4 | 政府合同+HN+GitHub+变更日志 |
extract_finance_landscape | 5 | 金融+HN+Reddit+GitHub+更新日志 |
extract_company_landscape | 5 | 任何公司的全貌 |
唯一--在任何其他MCP服务器中都不可用
| 适配器 | 源 | 它返回什么 |
|---|---|---|
extract_changelog | GitHub发布/NMP/自动发现 | 从任何仓库、包或网站更新历史记录 |
extract_govcontracts | USASpending.gov | 美国联邦合同授予——公司、金额、机构、期限 |
extract_sec_filings | SEC EDGAR | 8-K文件——法律规定的重大事件披露 |
extract_gdelt | GDELT项目 | 全球新闻情报——100多种语言,15分钟更新 |
extract_gebiz | data.gov.sg | 新加坡政府采购招标——开放数据集 |
______________________________________________________________________
快速开始
云(无需安装)
添加到您的Claude Desktop配置并重新启动:
雨衣: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"freshcontext": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"]
}
}
}重启克劳德。完成。
更喜欢有指导的设置?访问 freshcontext-site.pages.dev --3步,无终端。
本地(全职剧作家)
要求: Node.js 20+()
git clone https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
cd freshcontext-mcp
npm install
npx playwright install chromium
npm run build添加到Claude桌面配置:
雨衣:
{
"mcpServers": {
"freshcontext": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/path/to/freshcontext-mcp/dist/server.js"]
}
}
}窗户:
{
"mcpServers": {
"freshcontext": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\path\\to\\freshcontext-mcp\\dist\\server.js"]
}
}
}Mac故障排除
“找不到命令:node” --使用完整路径:
which node # copy this output, replace "node" in config配置文件不存在:
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json______________________________________________________________________
使用示例
我应该建立这个想法吗?
Use extract_idea_landscape with idea "procurement intelligence saas"返回资金信号、痛苦信号、拥挤信号、市场信号、生态系统信号和启动信号——所有这些信号都带有时间戳。
一次通话即可获取完整的公司情报:
Use extract_company_landscape with company "Palantir" and ticker "PLTR"SEC文件+联邦合同+全球新闻+更新日志+市场数据。
那家公司刚刚披露了什么重要信息吗?
Use extract_sec_filings with url "Palantir Technologies"8-K文件是在任何重大事件(首席执行官变更、收购、违约、重大合同)发生后的4个工作日内依法规定的。
这种依赖性是否仍在积极维持?
Use extract_changelog with url "https://github.com/org/repo"返回最后8个版本及其确切日期。如果最后一个版本是18个月前发布的,那么在固定版本之前,你就会知道了。
______________________________________________________________________
部署和基础设施
参考实现在Cloudflare的全球边缘运行:
| 端点 | 方法 | 目的 |
|---|---|---|
/ | GET | 服务信息+端点列表 |
/health | GET | 活体检查 |
/mcp | POST | MCP JSON-RPC传输 |
/demo | GET | 演示前/演示后直播(无需API密钥) |
/briefing | GET | 最新存储的简报 |
/v1/intel/feed/:profile_id | GET | DAR得分情报馈送 |
/watched-queries | GET | 列出所有关注的查询 |
- D1数据库 --18个观看查询在6小时cron上运行,并进行相关性评分
- KV支持的速率限制 --所有边缘节点上每个IP每分钟需要60个请求
- 防护阀 --时钟偏斜抑制(5分钟容差),R_t\<5时为硬底,读取时为延迟衰减
- 来源 --Ha Pri对每个信号进行SHA-256审计签名
- 架构迁移 --promise门控、幂等、部署后在第一个请求时运行
生产: https://freshcontext-mcp.gimmanuel73.workers.dev
______________________________________________________________________
路线图
- \[x\] FreshContext规范v1.1发布(麻省理工学院,开放标准)
- \[x\] 具有专有λ常数的DAR引擎(v0.3.17)
- \[x\] Ha Pri对每个信号进行审计签名
- \[x\] 通过指纹识别进行语义去重
- \[x\] 演示前/后现场直播
/demo - \[x\] METHODOLOGY.md——正式知识产权和工程文件
- \[x\] 21个参考工具,涵盖情报、竞争研究、市场数据和复合材料
- \[x\] Cloudflare Workers部署——全局边缘、KV缓存、KV速率限制
- \[x\] 在官方MCP注册表、Apify商店、npm上列出
- \[x\] GitHub Actions CI/CD——每次推送时自动发布
- \[\]Webhook触发器——将高熵信号推送到阈值
- \[\]仪表板——D1智能管道的React前端
- \[\]GKG升级
extract_gdelt--音调、戈德斯坦音阶、事件代码
______________________________________________________________________
贡献
PR欢迎。新适配器是最有价值的贡献——请参阅 src/adapters/ 对于模式和 FRESHCONTEXT_SPEC.md 任何适配器都必须履行合同。
如果你正在构建与FreshContext兼容的东西,打开一个问题,我们会将你添加到生态系统列表中。
______________________________________________________________________
许可证
麻省理工学院
______________________________________________________________________
*由加布里埃尔王子建造——纳米比亚格罗特方丹🇳🇦* *“这项工作还没有结束。它只是在等待继续。”*
______________________________________________________________________
