Skip to main content
Glama
FindDataTechnology

fd-find-data-business-mcp

Official

fd-findata-data-business-mcp

商业化的、需登录的 MCP 服务器,向付费用户提供 FindData 自有的爬取数据。以 fd-open-data-mcp 作为库依赖,并复用其缓存、调度和目录——但在响应中完全不暴露上游提供方身份。每个值都标记为 finddata;source_used / real_source_used 键永远不会到达客户端。

工具

工具

用途

read

读取某个实体在多个日期上的单个指标(提供新鲜或过期缓存;真正的未命中则在进程内调度)。

read_range

批量获取一个或多个指标在 [start, end] 范围内的序列。

list_concepts

浏览所有可用的 FindData 指标。

ai_search

自然语言指标 + 实体发现(所有搜索工具的超集)。

graph_search

实体关系图查询(bfs/dfs/neighbors/shortest_path/subgraph/ego_graph/statistics)。

Related MCP server: xbrl-financial

安装

pip install fd-find-data-business-mcp

运行(本地开发,无认证)

export FD_OPEN_DATA_MCP_DATABASE_URL=postgresql://fd:***@localhost:30432/fd_open_data
fd-find-data-business-mcp serve --transport http --host 0.0.0.0 --port 8310

未设置 FDBIZ_JWKS_URI 时,认证被禁用(冒烟测试 / 本地开发)。在部署中设置它,以拒绝所有没有有效 Logto 签发 JWT 的请求(在任何工具运行前返回 401)。

部署(zihan k3s,命名空间 fd-mcp)

认证通过 FastMCP 的 JWTVerifier 使用 Logto(RS256 JWT)。权威 Logto 实例运行在 guangzhou-xinru 上:

环境变量

值

FD_OPEN_DATA_MCP_DATABASE_URL

postgresql://fd:***@100.64.0.3:30432/fd_open_data(guangzhou-xinru 的网格地址)

FDBIZ_JWKS_URI

https://auth.finddatatech.cloud/oidc/jwks

FDBIZ_ISSUER

https://auth.finddatatech.cloud/oidc

FDBIZ_AUDIENCE

你在 Logto 管理后台注册的 API 资源标识符(推荐:https://api.finddatatech.cloud/mcp)

这四个键被添加到共享的 fd-mcp-env Secret 中(该 Secret 已携带 FD_OPEN_DATA_MCP_DATABASE_URL / REDIS_URL——业务 Pod 复用它们;来自兄弟 Pod 的 MCP_BEARER_TOKEN 在此处无效,此 Pod 使用 JWT 认证,而非 bearer):

# on zihan (sudo kubectl)
sudo kubectl -n fd-mcp create secret generic fd-mcp-env \
  --from-literal=FD_OPEN_DATA_MCP_DATABASE_URL='postgresql://fd:***@100.64.0.3:30432/fd_open_data' \
  --from-literal=REDIS_URL='redis://:***@100.64.0.3:30380/0' \
  --from-literal=FDBIZ_JWKS_URI='https://auth.finddatatech.cloud/oidc/jwks' \
  --from-literal=FDBIZ_ISSUER='https://auth.finddatatech.cloud/oidc' \
  --from-literal=FDBIZ_AUDIENCE='https://api.finddatatech.cloud/mcp' \
  --dry-run=client -o yaml | sudo kubectl apply -f -
sudo kubectl -n fd-mcp apply -f k8s/zihan/40-fd-find-data-business-mcp.yaml

可通过网格在 http://100.64.0.4:30803/mcp 访问(zihan NodePort 30803)。

Logto:注册 API 资源

在 Logto 管理控制台(https://auth-admin.finddatatech.cloud)中,创建一个标识符为 https://api.finddatatech.cloud/mcp 的 API 资源(这将作为签发令牌中的 aud 声明,且必须等于 FDBIZ_AUDIENCE)。创建一个授权给该受众的客户端(M2M 或第一方 SPA);付费用户的令牌必须携带 aud: https://api.finddatatech.cloud/mcp。

发布

OIDC 可信发布——v* 标签触发 .github/workflows/release.yml(构建 → twine 检查 → wheel 冒烟测试 → 发布到 PyPI)。Harbor 镜像由 .github/workflows/docker-publish.yml 在推送到 main / 标签时构建。

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides secure access to XBRL-US financial data with session-based authentication, enabling users to search for companies by fiscal year and retrieve their financial facts from SEC filings.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables querying and analyzing XBRL financial data through natural language, using an API key for authentication.
    6 npm
    1
    -
  • A
    license
    A
    quality
    B
    maintenance
    Gateway connector between LLM agents and world data, providing access to financial market prices, macroeconomic indicators, and news through a bundled endpoint catalog.
    8
    97 PyPI
    4
    MIT