diff --git a/assets/icon-sources.json b/assets/icon-sources.json index 452848d0..356b4d59 100644 --- a/assets/icon-sources.json +++ b/assets/icon-sources.json @@ -2559,5 +2559,14 @@ "homepage": "https://www.liblib.tv", "mimeType": "image/png", "sha256": "ada9717d540928baec64105056b93e8e8bc6cfbff145f9f3a9eadb6dd9b90689" + }, + { + "name": "twelvedata", + "icon": "twelvedata/icon.png", + "source": "https://twelvedata.com/build/favicons/favicon-512.png", + "matchedBy": "official-homepage-icon", + "homepage": "https://twelvedata.com", + "mimeType": "image/png", + "sha256": "bfb386759537c6652c302b987b19b2b9f2754a24e925c48e4cca7e733e7b8f40" } ] diff --git a/assets/twelvedata/icon.png b/assets/twelvedata/icon.png new file mode 100644 index 00000000..2ff94061 Binary files /dev/null and b/assets/twelvedata/icon.png differ diff --git a/external_plugins/twelvedata/.mcp.json b/external_plugins/twelvedata/.mcp.json new file mode 100644 index 00000000..c4a5fcaf --- /dev/null +++ b/external_plugins/twelvedata/.mcp.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "twelvedata": { + "type": "http", + "url": "https://mcp.twelvedata.com/mcp", + "enabled": true, + "timeoutMs": 30000 + } + } +} diff --git a/external_plugins/twelvedata/.zcode-plugin/plugin.json b/external_plugins/twelvedata/.zcode-plugin/plugin.json new file mode 100644 index 00000000..6bd64872 --- /dev/null +++ b/external_plugins/twelvedata/.zcode-plugin/plugin.json @@ -0,0 +1,29 @@ +{ + "name": "twelvedata", + "version": "0.1.0", + "description": "Twelve Data market data in ZCode: symbol search, real-time and historical prices, technical indicators, fundamentals, and reference data for stocks, ETFs, forex, and crypto through the official Twelve Data MCP server.", + "description_i18n": { + "en": "Twelve Data market data in ZCode: symbol search, real-time and historical prices, technical indicators, fundamentals, and reference data for stocks, ETFs, forex, and crypto through the official Twelve Data MCP server.", + "zh-CN": "在 ZCode 中使用 Twelve Data 市场数据:通过官方 Twelve Data MCP 服务查询股票、ETF、外汇和加密货币的代码搜索、实时与历史行情、技术指标、基本面和参考数据。" + }, + "author": { + "name": "Twelve Data", + "url": "https://twelvedata.com" + }, + "homepage": "https://twelvedata.com", + "repository": "https://github.com/twelvedata/mcp", + "keywords": [ + "twelvedata", + "finance", + "market-data", + "stocks", + "forex", + "crypto", + "mcp" + ], + "displayName": "Twelve Data", + "displayName_i18n": { + "en": "Twelve Data", + "zh-CN": "Twelve Data" + } +} diff --git a/external_plugins/twelvedata/README.md b/external_plugins/twelvedata/README.md new file mode 100644 index 00000000..2d35e516 --- /dev/null +++ b/external_plugins/twelvedata/README.md @@ -0,0 +1,40 @@ +# Twelve Data + +[中文文档](./README_CN.md) + +Market data from [Twelve Data](https://twelvedata.com) inside ZCode conversations. The plugin connects ZCode to the official Twelve Data MCP server, so agents can look up symbols, prices, indicators, and fundamentals without leaving the task. + +## What it provides + +One remote MCP server, `twelvedata`, with tools for: + +| Area | Tools | +| --- | --- | +| Search and reference | `search_symbol`, `get_reference_data`, `get_market_state`, `get_earliest_timestamp` | +| Prices | `get_quote`, `get_price`, `get_time_series`, `get_market_movers` | +| Analysis | `get_technical_indicator`, `get_analyst_data` | +| Fundamentals | `get_company_info`, `get_financials`, `get_statistics`, `get_earnings`, `get_dividends`, `get_splits`, `get_market_cap`, `get_ipo_calendar`, `get_company_news` | +| Funds and regulatory | `get_etf_data`, `get_mutual_fund_data`, `get_regulatory_data` | + +Coverage: stocks, ETFs, mutual funds, indices, forex, and crypto. + +## Setup + +1. Install the plugin from the Plugin Marketplace. +2. Open **Settings → MCP Servers**. The `twelvedata` server shows **Open authorization**. +3. Click **Open authorization**, sign in with your Twelve Data account, and click **Allow access**. Finish within 5 minutes, or ZCode cancels the attempt and you start again. +4. Start a new task and ask, for example: `Use Twelve Data to get the latest quote for AAPL, including price and volume.` + +You need a Twelve Data account. A free plan is available at [twelvedata.com/pricing](https://twelvedata.com/pricing). After sign-in, ZCode keeps the session, so you do not sign in again after a restart. + +## Network access and permissions + +- **Network:** the plugin talks only to `https://mcp.twelvedata.com/mcp` over HTTPS. +- **Sign-in:** OAuth in your browser. ZCode receives an access token for your Twelve Data account. The plugin cannot change your account or read your API key. You can revoke access from your Twelve Data account at any time. +- **Data and limits:** responses follow your Twelve Data plan, including its symbol coverage and request limits. Tool calls count toward your plan's API usage. +- **Local side effects:** none. The plugin has no commands, hooks, skills, or local processes, and writes no files. + +## Support + +- Twelve Data support: [support.twelvedata.com](https://support.twelvedata.com) +- Data terms: [twelvedata.com/terms](https://twelvedata.com/terms) diff --git a/external_plugins/twelvedata/README_CN.md b/external_plugins/twelvedata/README_CN.md new file mode 100644 index 00000000..293b99ff --- /dev/null +++ b/external_plugins/twelvedata/README_CN.md @@ -0,0 +1,40 @@ +# Twelve Data + +[English](./README.md) + +在 ZCode 对话中使用 [Twelve Data](https://twelvedata.com) 的市场数据。本插件将 ZCode 连接到官方 Twelve Data MCP 服务,Agent 无需离开当前任务即可查询证券代码、行情、技术指标和基本面数据。 + +## 提供的能力 + +一个远程 MCP 服务 `twelvedata`,包含以下工具: + +| 类别 | 工具 | +| --- | --- | +| 搜索与参考数据 | `search_symbol`、`get_reference_data`、`get_market_state`、`get_earliest_timestamp` | +| 行情 | `get_quote`、`get_price`、`get_time_series`、`get_market_movers` | +| 分析 | `get_technical_indicator`、`get_analyst_data` | +| 基本面 | `get_company_info`、`get_financials`、`get_statistics`、`get_earnings`、`get_dividends`、`get_splits`、`get_market_cap`、`get_ipo_calendar`、`get_company_news` | +| 基金与监管 | `get_etf_data`、`get_mutual_fund_data`、`get_regulatory_data` | + +覆盖范围:股票、ETF、共同基金、指数、外汇和加密货币。 + +## 安装与配置 + +1. 在插件市场中安装本插件。 +2. 打开 **Settings → MCP Servers**,`twelvedata` 服务会显示 **Open authorization**。 +3. 点击 **Open authorization**,使用你的 Twelve Data 账号登录,然后点击 **Allow access**。请在 5 分钟内完成,否则 ZCode 会取消本次授权,需要重新开始。 +4. 新建任务并提问,例如:`Use Twelve Data to get the latest quote for AAPL, including price and volume.` + +需要一个 Twelve Data 账号,可在 [twelvedata.com/pricing](https://twelvedata.com/pricing) 选择免费套餐。登录后 ZCode 会保存会话,重启后无需再次登录。 + +## 网络访问与权限 + +- **网络:** 插件仅通过 HTTPS 访问 `https://mcp.twelvedata.com/mcp`。 +- **登录:** 在浏览器中完成 OAuth 授权,ZCode 获得你的 Twelve Data 账号的访问令牌。插件无法修改你的账号,也无法读取你的 API Key。你可以随时在 Twelve Data 账号中撤销授权。 +- **数据与限额:** 返回的数据取决于你的 Twelve Data 套餐,包括可用的证券范围和请求限额。工具调用会计入你套餐的 API 用量。 +- **本地影响:** 无。插件不包含命令、hooks、skills 或本地进程,也不会写入任何文件。 + +## 支持 + +- Twelve Data 支持:[support.twelvedata.com](https://support.twelvedata.com) +- 数据条款:[twelvedata.com/terms](https://twelvedata.com/terms) diff --git a/marketplace.json b/marketplace.json index c7f09a06..525b81b1 100644 --- a/marketplace.json +++ b/marketplace.json @@ -1443,6 +1443,36 @@ "mcp", "verification" ] + }, + { + "name": "twelvedata", + "source": "./external_plugins/twelvedata", + "description": "Twelve Data market data in ZCode: symbol search, real-time and historical prices, technical indicators, fundamentals, and reference data for stocks, ETFs, forex, and crypto through the official Twelve Data MCP server.", + "description_i18n": { + "en": "Twelve Data market data in ZCode: symbol search, real-time and historical prices, technical indicators, fundamentals, and reference data for stocks, ETFs, forex, and crypto through the official Twelve Data MCP server.", + "zh-CN": "在 ZCode 中使用 Twelve Data 市场数据:通过官方 Twelve Data MCP 服务查询股票、ETF、外汇和加密货币的代码搜索、实时与历史行情、技术指标、基本面和参考数据。" + }, + "version": "0.1.0", + "author": { + "name": "Twelve Data", + "url": "https://twelvedata.com" + }, + "category": "finance", + "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/twelvedata/icon.png", + "displayName": "Twelve Data", + "displayName_i18n": { + "en": "Twelve Data", + "zh-CN": "Twelve Data" + }, + "keywords": [ + "twelvedata", + "finance", + "market-data", + "stocks", + "forex", + "crypto", + "mcp" + ] } ] } \ No newline at end of file