Skillget

tonghuasun-codex

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: AGPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Uyari
  • process.env — Environment variable access in plugin/src/ths-mcp-server/src/installer.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

将本机同花顺行情、账户资料和实时数据接入 Codex

README.md

仓库已经迁移到:https://github.com/zhuyifang/tonghuaxun-agent.git

请clone新仓库:https://github.com/zhuyifang/tonghuaxun-agent.git

tonghuasun-codex

tonghuasun-codex 将本机同花顺行情、账户资料和实时数据接入 Codex，并提供
MCP 交互界面与 Python SDK。

本项目不是同花顺官方产品，与同花顺品牌权利人不存在隶属、授权或背书关系。

开源内容

本仓库提供以下内容：

  • plugin/src/ths-mcp-server：安装配置器和 MCP 交互界面的构建源码；
  • plugins/tonghuasun-codex：Codex 插件清单、技能、界面与 Python SDK 源码；
  • plugins/tonghuasun-codex/payload/ths-plugin：同花顺连接组件的编译产物。

Codex 插件源码采用 AGPL-3.0-only 许可证。同花顺连接组件仅提供编译产物，采用
独立二进制许可。服务端及
同花顺连接组件源码不在本仓库提供，详细范围见
组件与授权范围。

Codex 插件安装

安装前准备

  • Windows 10 或 Windows 11；
  • 已安装并可正常登录的同花顺远航版；
  • 已安装 Codex 桌面端，并可在 PowerShell 中使用 codex 命令；
  • 已安装 Git 和 Node.js 20 或更高版本。

第一步：下载仓库

在 PowerShell 中执行：

git clone https://github.com/zhuyifang/tonghuasun-codex.git
cd tonghuasun-codex

后续命令都需要在 tonghuasun-codex 仓库根目录中执行。

第二步：添加插件市场

codex plugin marketplace add .

该命令会将当前仓库注册为名为 tonghuasun-codex 的本地插件市场。首次安装时执行
一次即可。

第三步：安装 Codex 插件

codex plugin add tonghuasun-codex@tonghuasun-codex

可以使用以下命令确认插件已经出现在 Codex 插件列表中：

codex plugin list

第四步：完成首次配置

  1. 正常退出同花顺，确认同花顺主程序已经完全关闭；
  2. 在 Codex 中新建任务；
  3. 输入“配置同花顺插件”；
  4. Codex 会检查同花顺安装目录、部署连接组件，并生成仅供本机使用的访问令牌；
  5. 如果没有自动找到同花顺，按提示提供同花顺安装目录即可。

不要手工修改插件映射、端口或访问令牌，统一通过“配置同花顺插件”或“修复同花顺
插件”完成。

第五步：启动并验证

  1. 通过同花顺桌面快捷方式或开始菜单正常启动同花顺；
  2. 如果 Codex 在安装前已经打开，请新建任务，让 Codex 重新加载插件；
  3. 输入“检查同花顺插件状态”；
  4. 状态检查会确认本机端点已经发布、端口一致且组件映射全部健康；
  5. 验证成功后，Codex 会简要显示 MCP、REST API、OpenAPI 和实时 WebSocket 的
    本机地址与用途。

完成后即可尝试输入：

  • “查看我的持仓和各账户资产汇总”；
  • “查看 600519 的证券资料和 K 线”；
  • “持续盯盘这只股票的逐笔成交与委托变化”。

更新插件

在仓库根目录执行：

git pull
codex plugin add tonghuasun-codex@tonghuasun-codex

更新后请新建 Codex 任务。如果发行包包含新的同花顺连接组件，请先正常退出同花顺，
再输入“修复同花顺插件”，完成后重新启动同花顺。

启动后的本机入口

默认端口为 17180，如果配置时修改过端口，以配置器返回的地址为准。

入口 默认地址 用途
MCP http://127.0.0.1:17180/mcp 供 Codex 加载和调用同花顺工具
REST API http://127.0.0.1:17180/api/v2 供本机程序通过 HTTP 调用接口
OpenAPI http://127.0.0.1:17180/openapi/v2.json 查看 REST API 的接口定义
实时 WebSocket ws://127.0.0.1:17180/api/v2/realtime/ws 订阅实时行情和事件推送

这些入口仅监听本机，访问时需要安装器生成的本机访问令牌。配置器只会说明入口，
不会在对话中显示令牌。

本地开发

需要 Node.js 20+ 和 Python 3.10+。

cd plugin/src/ths-mcp-server
npm ci
npm test

$env:PYTHONPATH="$PWD/../../../plugins/tonghuasun-codex/sdk/python/src"
python -m unittest discover ../../../plugins/tonghuasun-codex/sdk/python/tests -v

仓库已包含与当前版本匹配的同花顺连接组件编译产物，可用于本机安装和联调。

安全

本地访问令牌由安装器按设备生成。仓库中的 .mcp.json 只包含不可用的安装占位值；
真实令牌、.env.local、.secrets/、私钥和账户日志禁止提交。安全问题请按
安全政策 私下报告。

许可证

除 组件与授权范围 中列明的编译产物和第三方组件外，
本仓库中的 Codex 插件源码按 AGPL-3.0-only 开放。分发或部署修改版本时必须公开对应源码、标注修改，并保留
NOTICE 与 第 7 条附加条款 指定的项目来源。

第三方组件继续适用其原许可证，详见 第三方声明。

Yorumlar (0)

Sonuc bulunamadi