Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -812,6 +812,11 @@
"name": "lmty",
"source": "third_party/lmty",
"description": "Read tracked competitors, competitive intelligence reports, change logs, evidence, social mentions, and market feeds for your products, and browse LMTY's public Markets, event timelines, and company, product, and person profiles."
},
{
"name": "fiu-mcp-connector",
"source": "fiu-mcp-connector",
"description": "Query FIU global market and financial data through a read-only MCP server."
}
]
}
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `createos` | [CreateOS](third_party/createos/) | Cursor | Integrations | Deploy and manage projects, environments, deployments, domains, logs, cron jobs, security scans, templates, and sandboxes on NodeOps CreateOS. |
| `fiscal-ai` | [Fiscal.ai](third_party/fiscal-ai/) | Cursor | Integrations | Pull source-linked financials, filings, ratios, prices, segments, KPIs, ownership, fund letters, and news from Fiscal.ai. |
| `lmty` | [LMTY](third_party/lmty/) | Cursor | Integrations | Read tracked competitors, competitive intelligence reports, change logs, evidence, social mentions, and market feeds for your products, and browse LMTY's public Markets, event timelines, and company, product, and person profiles. |
| `fiu-mcp-connector` | [FIU Global Financial Data](fiu-mcp-connector/) | 深圳市融聚汇信息科技有限公司 | Finance | Query FIU global market and financial data through a read-only MCP server. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).

## Repository structure
Expand Down
30 changes: 30 additions & 0 deletions fiu-mcp-connector/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"name": "fiu-mcp-connector",
"displayName": "FIU Global Financial Data",
"version": "1.0.1",
"description": "Query objective global market quotes, financial statements, company data, funds, bonds, IPOs, news, calendars and macroeconomic data through FIU MCP. Read-only data retrieval; no investment advice or trading operations.",
"author": {
"name": "深圳市融聚汇信息科技有限公司"
},
"homepage": "https://ai.szfiu.com",
"repository": "https://gitlab.szfiu.com/ai/szfiu-mcp-adapter",
"license": "LicenseRef-Proprietary",
"keywords": [
"finance",
"market-data",
"mcp",
"stocks",
"funds",
"bonds"
],
"category": "finance",
"tags": [
"finance",
"market-data",
"read-only",
"mcp"
],
"skills": "./skills/",
"mcpServers": "./mcp.json",
"logo": "icon.svg"
}
7 changes: 7 additions & 0 deletions fiu-mcp-connector/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Changelog

## 1.0.1 - 2026-11-20

- Added the Cursor plugin manifest and marketplace entry.
- Added Cursor Streamable HTTP MCP configuration using `FIU_API_KEY`.
- Ported the FIU data-query skill from the generic connector package.
7 changes: 7 additions & 0 deletions fiu-mcp-connector/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
Copyright (c) 2026 深圳市融聚汇信息科技有限公司

All rights reserved.

This plugin package and its documentation may be used only through an authorized
installation of the FIU service. No part of this package may be copied, modified,
redistributed or sublicensed without prior written permission from the copyright holder.
37 changes: 37 additions & 0 deletions fiu-mcp-connector/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# FIU Global Financial Data for Cursor

This Cursor plugin connects to the FIU read-only MCP service at `https://ai.szfiu.com/api/mcp/v2`.
It provides global market quotes, K-lines, company information, financial statements, holdings,
funds, bonds, IPOs, news, announcements, calendars and macroeconomic data.

## Installation

Install `fiu-mcp-connector` from the Cursor plugin marketplace. The package includes the
`fiu-data-query` skill and the `fiu-finance-data` Streamable HTTP MCP server.

## Authentication

The server expects an FIU access token in the `Authorization` header. Set the token in the
environment before starting or restarting Cursor:

```text
FIU_API_KEY=<token from https://ai.szfiu.com/login>
```

Use the token value only. Do not include the `Bearer` prefix or quotes. The plugin injects the
header as `Authorization: Bearer ${env:FIU_API_KEY}`.

If the Cursor marketplace changes its supported secret-input syntax, update `mcp.json` to the
syntax accepted by the marketplace and keep this setup description in sync.

## Capabilities

The `fiu-data-query` skill explains how to select the narrowest FIU endpoint, resolve unknown
securities, read endpoint schemas and preserve source values and missing data. The service is
read-only and does not place orders, transfer funds or manage brokerage accounts.

## Data and service terms

The plugin contains no access token. Data availability, permissions, rate limits and service
terms are controlled by FIU. Use the service only with an account and credentials you are
authorized to use.
20 changes: 20 additions & 0 deletions fiu-mcp-connector/icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 11 additions & 0 deletions fiu-mcp-connector/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"mcpServers": {
"fiu-finance-data": {
"type": "streamableHttp",
"url": "https://ai.szfiu.com/api/mcp/v2",
"headers": {
"Authorization": "Bearer ${env:FIU_API_KEY}"
}
}
}
}
36 changes: 36 additions & 0 deletions fiu-mcp-connector/skills/fiu-data-query/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
name: fiu-data-query
description: FIU 金融事实数据查询;用于行情、K线、财务、公司资料、持股、基金、债券、期权、IPO、新闻、公告和宏观数据,不用于投资建议或下单。
---

# FIU 金融数据查询

通过 Cursor 已连接的 FIU MCP 查询金融事实。已知代码直接使用最窄 endpoint;未知证券调用 `search`,全球基金使用 `fund_data.search_funds`。存在多个上市地或同名候选时先确认证券主体。

## 授权前置条件

使用插件配置的 `fiu-finance-data` 原生 MCP 工具。用户先设置 `FIU_API_KEY` 环境变量,只填写令牌本身,不包含 `Bearer` 前缀或引号。Cursor 通过 `mcp.json` 将它注入 `Authorization` 请求头。

不要读取本机配置寻找凭证,不索要或记录 Token,不把凭证写入业务参数、对话、结果或日志。认证失败时请用户检查环境变量和 FIU 授权;权限不足时如实说明服务返回的权限限制。

## 查询流程

1. 确认市场、资产类型、标的、日期范围、频率和所需字段。
2. 先读 [调用参考](references/tool-contract.md) 选择模块。工具描述和 `describe_tool` 是完整参数、必填条件、类型、默认值和枚举的依据。
3. `search` 直接传入对象中的 `key` 字符串。业务模块传 `endpoint` 字符串和 `params` 对象。不要把搜索包装为业务 endpoint。
4. 仅在参数或分支不明确时使用 `describe_tool`;独立查询可以并行,避免重复检索与无关调用。
5. 按[调用参考](references/tool-contract.md)检查状态、列序、时间、币种和报告期,返回用户所需的核心数据。

## 查询边界

证券代码优先复用搜索返回的完整后缀;已有后缀与 `market` 冲突时先修正。常用市场为 HK、US、CN、JP;债券使用 GLOBAL;其他组合以 schema 为准。

三大报表 `reportType` 按市场选择:HK 为 F/I/P/Q1-Q4;US 为 FY/I1/I2/Q1-Q4;CN 为 1/6/9/12/99。结合 `coverMonths`、`periodScope` 和 `periodDescription` 区分单季与累计,不用自然月猜测美股财季。

全球基金返回的 `fundid` / `fundclassid` 分别用于 `fund_id` / `fund_class_id`。新闻不能替代上市公司公告,公告使用 `company_announcements`。字段、默认值和分页不得猜测。

## 高风险操作与确认

本插件提供只读数据查询,没有下单、转账、交易授权或账户管理能力。用户要求这些操作时说明能力边界,不得借助外部命令代为执行。下载或导出到用户指定位置时如需覆盖已有文件,先确认覆盖范围。

只进行数据检索、字段整理及有明确标注的客观计算;不生成个性化投资建议、评级、收益保证或买卖结论。保留 `null` 和数据缺失,不补造来源、时间、单位、会计准则或重述信息。
Loading