Skip to main content
Glama
fridaruh

tools4foresight

by fridaruh

MCP Tools4Foresight

关于 tools4foresight.com 的远见信号的只读 MCP 服务器。它让代理能够访问与成员看到的相同地图:经过筛选的信号、语义图、带有历史的主题以及三个视野。

不写入任何内容。 没有任何一个工具会修改、发布或删除任何内容。参见 SECURITY.md。

代理可以用它做什么

  • “地图的状态如何?” → H1/H2/H3 概览及其宏观主题。

  • “哪些主题在增长,哪些在消退?” → 按主题的时间序列。

  • “总结 AI 代理主题” → 包含四个指标及其信号的卡片。

  • “什么与这个信号相似?” → 语义邻居,无需离开筛选后的地图。

  • “H3 中有哪些弱信号?” → 新颖度高的小型主题。

  • “这个月什么消失了?” → 通过比较快照得到的化石。

Related MCP server: OKF MCP Server

安装

你需要一个 tools4foresight API 密钥(向管理员索取)。

Claude Code

claude mcp add tools4foresight \
  --env T4F_API_KEY=tu-api-key \
  -- npx -y mcp-tools4foresight

Claude Desktop

在 claude_desktop_config.json 中:

{
  "mcpServers": {
    "tools4foresight": {
      "command": "npx",
      "args": ["-y", "mcp-tools4foresight"],
      "env": { "T4F_API_KEY": "tu-api-key" }
    }
  }
}

Cursor

在 .cursor/mcp.json 中,使用与 Claude Desktop 相同的配置块。

远程(HTTP)

如果你希望部署一次并让多个代理使用,请参阅 docs/DEPLOYMENT.md。远程端点要求自己的凭据(MCP_ACCESS_TOKEN),与 API 密钥不同。

在 .mcp.json.example 中有一个完整示例。

环境变量

变量

必需

默认值

说明

T4F_API_KEY

是

—

此服务器针对 tools4foresight API 的密钥

T4F_API_BASE_URL

否

https://tools4foresight.com/api/public/v1

用于指向本地环境

T4F_TIMEOUT_MS

否

15000

每次请求的超时时间

T4F_RETRIES

否

2

在 429/5xx/网络错误时重试。401 从不重试

T4F_CACHE_TTL_MS

否

60000

0 禁用内存缓存

T4F_LOG_LEVEL

否

error

silent、error 或 debug。始终输出到 stderr

MCP_ACCESS_TOKEN

仅 HTTP

—

此服务器要求调用者提供的凭据

MCP_PORT

否

3333

本地 HTTP 服务器的端口

18 个工具

完整参考及示例见 docs/TOOLS.md。

主题

工具

信号

list_signals, search_signals, get_signal, get_signal_neighbors

主题

list_themes, get_theme, list_theme_signals, get_theme_history, list_macro_themes

视野

get_horizons_overview, get_horizon

分类法

list_categories, list_pestel_dimensions, get_corpus_overview

图

get_graph

快照

list_snapshots, get_snapshot

方法

explain_foresight_term

另外还有 7 个资源,用于从 Claude Desktop 或 Cursor 手动附加上下文:foresight://overview、://glossary、://horizons、://signal/{id}、://theme/{id}、://horizon/{key} 和 ://macro-theme/{id}。

还有 6 个提示词——建议的对话脚本,不提供任何额外能力——用于常见问题:analizar_horizonte、informe_de_tema、radar_semanal、senales_debiles、comparar_temas 和 explorar_desde_senal。

此服务器用于探索:发布、取消发布、编辑分析或重新计算图仍然在 tools4foresight 中完成,这些功能都不在此处暴露。

阅读输出前需要了解的三件事

  1. 信号日期是估计值。 X 的 API 不公开点赞发生的时间,只公开顺序。因此 likedAt 始终以 ~ 显示。

  2. 已死亡的主题是化石,不是删除。 它会被保留,并且可以复活。地图上不会删除任何内容。

  3. 相似度百分比不会显示给人。 0.63 会被解读为该方法不具备的精度。使用 strength(强/中/弱);原始 score 可供代理推理使用。

该方法的完整术语表位于 docs/DOMAIN.md,可以通过 explain_foresight_term 实时查询。

文档

文档

用途

docs/TOOLS.md

每个工具,附示例输入和输出

docs/API.md

所消费的公共 API 的契约

docs/ARCHITECTURE.md

如何构建以及为什么

docs/DOMAIN.md

远见方法术语表

docs/DEPLOYMENT.md

部署远程模式

SECURITY.md

哪些内容永远不会被暴露

CONTRIBUTING.md

如何添加工具

许可证

代码采用 MIT 许可证。它提供的内容则不是:tools4foresight 的信号和地图是付费订阅材料。

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Provides read-only hybrid RAG search and discovery over a local-first AI knowledge corpus, enabling semantic and keyword search, browse, digest, and status tools.
    4
    1
    PolyForm Noncommercial 1.0.0
  • F
    license
    Not graded
    quality
    B
    maintenance
    Provides read-only access to a personal RAG knowledge base, enabling hybrid search, evidence-grounded retrieval with citations, and knowledge gap tracking for LLM agents.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables read-only access to curated Datum data platform marts, including products, resources, consensus questions, and health metrics, through MCP tools such as list_products, list_questions, ask, query, and health.
    1 npm
    -
  • A
    license
    A
    quality
    B
    maintenance
    Enables read-only investigative research across any Aleph instance, providing ten GET-only tools for searching entities, exploring relationships, discovering datasets, and retrieving document text through MCP clients.
    10
    MIT