Fodda MCP

Fodda MCP服务器

专家为人工智能代理策划的知识图谱 --通过模型上下文协议，零售、美容、体育、文化等领域的100多个数据集。

 ](https://www.npmjs.com/package/fodda-mcp) 

______________________________________________________________________

你的AI会产生通用输出，因为它具有通用上下文。Fodda为其提供了专家策划的知识和真实的机构证据，因此它能够更好地推理并解释其工作。

与平面文本或通用检索不同，Fodda将洞察力组织为相互关联的实体、关系、证据和元数据，为人工智能系统提供了可信、可解释的输出所需的定性背景和定量证据。

快速开始 · 可用工具 · 图形展示 · 运作原理 · REST API · 最佳实践

______________________________________________________________________

快速开始

收到API密钥后(sk_live_...)，使用您喜欢的工具连接到Fodda：

克劳德（专业/Max/团队/企业）

Connector URL: https://mcp.fodda.ai/mcp?api_key=YOUR_API_KEY&user_id=YOUR_EMAIL

粘贴到： 克劳德→ 设置→ 连接器→ 添加自定义连接器.保留OAuth字段 空白.

克劳德代码（CLI）

claude mcp add --transport sse fodda https://mcp.fodda.ai/sse \
  --header "Authorization: Bearer YOUR_API_KEY"

克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "fodda": {
      "url": "https://mcp.fodda.ai/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

光标/风帆/任何MCP客户端

{
  "mcpServers": {
    "fodda": {
      "url": "https://mcp.fodda.ai/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

概念（商业/企业）

1. 海关代理人→ 工具和访问→ 添加连接→ 自定义MCP服务器
2. 网址： https://mcp.fodda.ai/mcp?api_key=YOUR_API_KEY&user_id=YOUR_EMAIL
3. 身份验证类型：API密钥→ Key: api_key，价值： YOUR_API_KEY

微软365复制品

在VS代码中使用代理工具包→ 添加操作→ 从MCP服务器开始→ URL: https://mcp.fodda.ai/sse

谷歌双子座（通过顶点AI）

{
  "tools": [{
    "type": "mcp",
    "name": "fodda",
    "url": "https://mcp.fodda.ai/sse",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY",
      "X-Fodda-Mode": "deterministic"
    }
  }]
}

OpenAI Codex/ChatGPT（通过REST API）

# List available graphs (public, no auth required)
curl https://api.fodda.ai/v1/graphs/catalog

# Search a graph
curl -X POST https://api.fodda.ai/v1/graphs/retail/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "checkout friction", "limit": 10, "use_semantic": true}'

还没有API密钥？ 通过在中添加这些试用连接器之一，立即尝试Fodda 克劳德: |图表|试用连接器URL| |-------|---------------------| | 🛒 零售业| https://mcp.fodda.ai/mcp?api_key=sk_trial_retail&user_id=claude-user | | 💄 美丽 https://mcp.fodda.ai/mcp?api_key=sk_trial_beauty&user_id=claude-user | | ⚽ 体育| https://mcp.fodda.ai/mcp?api_key=sk_trial_sports&user_id=claude-user |

______________________________________________________________________

可用工具

连接后，您的代理可以访问这些工具：

通过MCP使用Fodda时，您的代理可以访问 22个实时机构数据源 涵盖美国经济指标、健康与科学数据库、全球贸易数据、学术研究和消费市场信号。这些可通过统一 get_supplemental_context 工具——您不需要直接调用单个源。

发现端点

______________________________________________________________________

图形展示

福达主机 100+专家策划的知识图谱。以下是一些亮点：

查看所有图表： curl https://api.fodda.ai/v1/graphs/catalog

______________________________________________________________________

运作原理

Your Agent (Claude, Cursor, Gemini, Copilot, etc.)
        ↓ calls MCP tools
Fodda MCP Server (mcp.fodda.ai)
        ↓ translates to REST calls
Fodda API (api.fodda.ai)
        ↓ queries
Neo4j Knowledge Graphs + Supplemental Sources

典型提示期间会发生什么

当你向你的代理提出一个研究问题时，MCP服务器会在幕后协调多个工具调用：

1. list_graphs --代理发现哪些图与您的查询相关
2. search_graph --在一个或多个图上进行混合语义+关键字搜索
3. get_evidence --检索支持热门趋势的源文章
4. search_statistics --提取精心策划的指标、专家报价和信号
5. get_supplemental_context --统一的补充工具根据您的查询内容启动相关的机构数据源，返回经济、健康、学术和市场类别的定量证据
6. get_adjacent_trends --发现跨图形边界的相关趋势

单个提示通常是链式的 6-10次工具调用 -这就是为什么1个MCP提示≈8个API调用。

补充数据

统一的补充工具根据主题和领域智能地将您的查询路由到最相关的机构数据源。结果被整合到五个稳定的类别中——需求信号、经济背景、市场数据、研究信号和人口背景——并被编织到具有完整来源归因的代理响应中。

______________________________________________________________________

API调用用法

通过以下方式检查余额 get_my_account 工具或at App.fodda.ai.

______________________________________________________________________

REST API参考

基本URL: https://api.fodda.ai

所有私人请求都需要： X-API-Key: YOUR_API_KEY

公共端点（无需身份验证）

• GET/v1/图形/目录 --公共图形注册表
• POST/v1/psfk/概述 --LLM综合行业概述

核心图端点（需要API键）

• POST/v1/graphs/：graph_id/搜索 --混合语义+关键字搜索
• GET/v1/graphs/：graph_id/nodes/：node_id --节点元数据查找
• POST/v1/graphs/：graph_id/邻居 --图遍历
• POST/v1/graphs/：graph_id/证据 --趋势的源文章
• GET/v1/graphs/：graph_id/统计 --精心策划的指标、报价、信号
• GET/v1/graphs/：graph_id/相邻 --语义相似的趋势
• POST/v1/品牌情报/：brandName --交叉图品牌分析

多图形搜索终结点（需要API键）

• POST/v1/搜索/域 --搜索所有精选的领域图
• POST/v1/搜索/专家 --搜索所有专家图表
• POST/v1/搜索/报告 --搜索所有行业报告图表
• POST/v1/搜索/过滤 --使用元数据过滤器的语义搜索

研究终点（需要API密钥）

• POST/v1/研究/深潜 --自主深潜研究
• POST/v1/研究/聊天 --使用会话记忆的多回合研究

Copilot适配器端点（需要API密钥）

• POST/副驾驶/搜索_景点 --平淡的叙事见解
• POST/副驾驶/获取证据 --趋势级支持文章
• POST/副驾驶/获取统计数据 --定量统计搜索

API完整文档： app.foda.ai/知识/api-docs

______________________________________________________________________

认证

将您的Fodda API密钥作为Bearer代币传递：

Authorization: Bearer sk_live_...

______________________________________________________________________

故障排除

______________________________________________________________________

最佳实践

1. 使用主题、对话式查询：完整的句子效果最好——例如。， *“零售商如何消除购买过程中的摩擦？”* 优于短关键字，如 *“检查摩擦”*
2. 搜索，然后深潜：首先 search_graph，然后使用 get_evidence 和 search_statistics 关于具体趋势
3. 交叉图发现：使用 get_adjacent_trends 查找域之间的连接，或 search_domain_graphs 一次搜索所有精选图表
4. 用数据验证：使用 get_supplemental_context 添加来自机构数据源的定量支持
5. 使用筛选搜索：当你知道你在找什么时，使用 search_filtered 使用类别、日期、品牌或地理过滤器获得精确结果

______________________________________________________________________

MCP注册表

此服务器已发布到 MCP官方登记处 作为 io.github.piers-fawkes/fodda.

# Verify listing
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.piers-fawkes/fodda"

______________________________________________________________________

链接

• 网站: 福达.艾
• 应用: App.fodda.ai
• API文件: app.foda.ai/知识/api-docs
• 快速入门指南: Fodda_Quickstart.md
• npm: 福达mcp
• 支持: piers.fawkes@psfk.com

______________________________________________________________________

许可证

专有-- 福达.艾