프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Horosa Skill

제작자: Horace-Maxwell버전 0.47.3i★ –i내 컴퓨터에서 실행
레지스트리 이름io.github.Horace-Maxwell/horosa-skill

설치

개요

제작자가 쓴 설명(영어 원문)

Local-first offline 术数/占星 (Horosa 星阙): 114 technique tools, all computed on your machine.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 내 컴퓨터에서 실행
  • 전송 방식: stdio
  • 카테고리: 기타
  • 입력해야 할 값: HOROSA_JEV_API_KEY

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

  • 기본 점검: 1개 중 1개 통과
  • 내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
  • 직접 입력할 값: HOROSA_RUNTIME_ROOT, HOROSA_SKILL_DATA_DIR, HOROSA_JEV, HOROSA_JEV_API_KEY

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

제작자의 .mcpb 파일 다운로드

링크는 제작자의 파일로 바로 연결돼요. 우리가 보관하거나 다시 패키징하지 않아요. 파일을 열면 Claude Desktop이 설치해요.

터미널에서 이 명령어를 실행하세요

실행하기 전에 빈 값을 채워 주세요.

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

  • HOROSA_RUNTIME_ROOT env
    Offline runtime directory (default ~/.horosa/runtime or %LOCALAPPDATA%\\Horosa\\runtime)
  • HOROSA_SKILL_DATA_DIR env
    Local runs / reports / SQLite directory (default ~/.horosa-skill)
  • HOROSA_JEV env
    Optional cloud decision layer (TypeSafe Jev): off (default, fully local) / shadow / enforce
  • HOROSA_JEV_API_KEY 비밀 env
    TypeSafe Jev API key; only read when HOROSA_JEV is not off

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 Horace-Maxwell 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 18372개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 18372개 중 100%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 18372개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Horosa Skill, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: HOROSA_JEV_API_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.47.3)은 오늘 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 MCPB도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, A1RO — Irish employment tools

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트
설치

Remote Desktop Commander

제작자: desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

클라우드에서 실행★ 211그저께 업데이트
설치

Irish temp worker cost, public holiday pay and holidays, and SafeHandle certificate checks.

클라우드에서 실행오늘 업데이트
설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

🔮 Horosa Skill

把星阙(Horosa)的 114 个真实术数 / 占星技法,做成任何 AI 都能本地调用的 MCP server 与 CLI。

A local-first MCP server & CLI that exposes 114 real astrology / metaphysics techniques from Horosa (星阙) to any AI client.

简体中文 · English


✨✨✨
🌌 114 技法一次装齐⚡ 算法本机跑 · 断网可用🛡️ AI 不许乱补参数
🧾 结论可溯源 · 技法依据卡📚 31 域知识库 · 引必带出处🧪 忠实性评测 · 幻觉判红
🔀 多技法合参 · 分歧必披露🗄️ 调用自动落库 · 一键出报告🔓 免费 · 开源 · AGPL

克隆仓库、安装一次离线 runtime,Claude Code / Claude Desktop / Codex / Open WebUI / OpenClaw 等客户端即可通过 MCP 或 JSON-first CLI 直接调用真实的星阙方法:西洋本命 / 推运 / 卜卦 / 择日,八字 / 紫微 / 大六壬 / 奇门 / 太乙 / 金口诀 / 三式合一,六爻 / 塔罗 / 天文地占 / 灵棋经 / 小六壬 / 飞宫小奇门 / 小成图 / 皇极轨策 / 神数正传,以及全 14 路神数。

算法在本机运行,断网可用;每个技法返回统一 envelope 与星阙式导出结构,并附一张确定性的技法依据卡;每次调用自动落成可检索的本地记录。与星阙桌面端共用同一套后端、逐值同源(导出契约 v16 镜像桌面端 aiExport v60,星阙 v3.11.3)。

   🖥️  AI 客户端   Claude Code · Claude Desktop · Codex · Open WebUI · OpenClaw

│ │ MCP / JSON-first CLI ▼ ┌──────────────────────────────────────────────────────────────┐ │ 🔮 Horosa Skill 本地进程 · 114 工具 · 澄清闸 · 统一 envelope │ │ 自然语言调度 · 多技法合参 · 技法依据卡 · 报告渲染 · 记忆检索 │ └──────────────────────────────────────────────────────────────┘ │ 全部在本机 · 断网可用 ▼ ⚙️ 离线 runtime 🧩 headless JS 引擎 💾 本地存储 Java+Python 星历 horosa-core-js SQLite 全文索引 ken / kentang 引擎 aiExport 结构化 + JSON artifact 归档

[!NOTE]

它不是又造一个简化占算器,而是把星阙已有的本地算法、星历与导出协议,整理成一层适合 GitHub 分发、适合 AI 调用、适合长期本地管理的接口。桌面端算出来是什么,这里就是什么——而且每个结论都能回答「这盘怎么来的」。

📑 目录

  • ✨ 核心特性
  • 🚀 快速开始
  • 🔌 接入 AI 客户端
  • 🎯 一次调用的完整流程
  • 🧭 技法总览
  • 📐 输出契约
  • 🚦 调用前的澄清闸
  • 🧾 可信度体系
  • 📂 本地记忆与报告
  • 📦 安装与 runtime 策略
  • ✅ 质量与验证
  • 📚 文档
  • 🙏 致谢与许可证

✨ 核心特性

  • 🌌 114 个真实技法,一次安装,全程离线。 覆盖西洋占星全链路、中文术数主干、数算与卜法、全 14 路神数;算法在本机运行,不联网、不上传。
  • 🧠 为 AI 消费而设计的稳定契约。 每次调用返回统一 envelope,接入导出协议的技法附带 export_snapshot(段结构化正文)。同一技法连续调用得到同一套字段,落库后结构不丢。
  • 🛡️ 调用前的硬性澄清闸。 只要技法受时间 / 地点 / 时区 / 性别 / 事项 / 宫制 / 历法 / 起局方式影响,agent 在用户确认前会被结构化拦截,并收到可直接转发给用户的追问文本。
  • 🧾 每个结论可溯源。 响应自带技法依据卡(技法 / 流派口径 / 谁算的 / 段落全不全 / 版本链),horosa_technique_report 一键出方法报告,会话级自动检出跨技法口径冲突。
  • 📚 31 域方法论知识库,引必带出处。 星阙 app 内 hover 知识三域 + 27 份技法操作手册 + 八字断语库(21 类口诀)共 416 条,逐条带上游文件与版本出处;没有出处的解读必须明说是通则推理。
  • 🧪 盘面事实忠实性评测。 确定性校验器把 AI 解读逐句对盘面机读真值,判 supported / invented / contradicted;喂错盘与诱导复述判红;106 条基准用例与工具注册表锁步。
  • 🔀 一问多技法合参。 horosa_hecan 并行起盘 + 合参模板:每条结论必须绑定真实段落,收敛与分歧分开填,分歧必须披露、不许平均。
  • 🪙 精简的响应体量。 导出契约单份化,同一份快照不再重复;大盘单次响应体量较早期显著下降。可用 response_view=titles|sections 仅取段标题或指定段,完整快照始终已归档。
  • ⏳ 主限法可推至 3000 年。 逐位核验的核5方位法 + 22 项时间钥匙 + In Zodiaco / In Mundo + 宿命点(Vertex)应星 + 映点 / 界作迫星,多圈复发行。
  • 🗄️ 完整的本地记录系统。 SQLite 全文检索(trigram,中文子串可命中)+ JSON artifact 归档;按人名 / 技法 / 日期区间 / 全文组合检索,跨会话找回历史。
  • 📄 结构化报告导出。 一条命令生成 DOCX / PDF / JSON;Markdown 表格渲染为真 Word 表格,含导航大纲、目录、页码与中文字体;style=chart 不经 AI 直接出完整排盘报告。
  • 📚 自备知识库。 自己的笔记放进知识库文件夹,计算时按名 / 标签 / auto 点选,随结果附进 AI 上下文。
  • 🔁 成熟的安装与升级链。 断点续传、多镜像回退、实时进度;版本短路(已最新则跳过下载);upgrade / uninstall / selfcheck / doctor 环境体检齐备。
  • 🔗 同源后端。 奇门 / 太乙 / 金口诀走星阙 ken 后端;14 路神数走 chart 服务上挂载的 kentang 引擎;结果由 headless JS 层重排为 aiExport.js 段结构。

🚀 快速开始

[!TIP]

前置只需 uv:macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh;Windows(PowerShell)powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"。装完 重开终端(或 source $HOME/.local/bin/env)让 uv 进 PATH;Python ≥ 3.12 由 uv 自动准备;磁盘预留约 5 GB(runtime 下载约 730 MB、解压后约 2 GB)。

git clone https://github.com/Horace-Maxwell/horosa-skill.git

cd horosa-skill/horosa-skill uv sync uv run horosa-skill install # 📦 安装离线 runtime(带进度 / 断点续传;已最新则跳过下载) uv run horosa-skill doctor # 🩺 环境体检(磁盘 / 端口 / node 实跑探针,期望 issues: []) uv run horosa-skill selfcheck # ✅ 活体验证:起一张盘 → 存 → 读回 uv run horosa-skill serve # 🚀 启动本地 MCP(默认 http://127.0.0.1:8765/mcp)

不想 clone 源码?零安装(无需 git、无需 PyPI)——每个发布页都附带纯 Python wheel,uvx 直接从 URL 起, HOROSA_RUNTIME_MIRROR 对 wheel 与 runtime 一并生效:

WHL="https://github.com/Horace-Maxwell/horosa-skill/releases/download/v0.47.3/horosa_skill-0.47.3-py3-none-any.whl"

uvx --from "$WHL" horosa-skill install # 📦 装离线 runtime(同上) uvx --from "$WHL" horosa-skill doctor # 🩺 体检 uvx --from "$WHL" horosa-skill setup --client cursor # 🪄 零安装一条命令接入(自动选 --launcher uvx-wheel,配置里写 wheel URL) uvx --from "$WHL" horosa-skill serve --transport stdio # 🚀 给客户端直连;client config --launcher uvx-wheel 生成对应配置

github.com 直连不通(镜像 / API 直链 / U 盘离线搬运 / 代理与企业证书)见 docs/INSTALL_RESTRICTED_NETWORK.md。

PyPI 通道(uvx horosa-skill …)已就绪但暂未开通(等维护者完成一次性 Trusted Publisher 配置),开通后命令更短、行为不变。

[!NOTE]

🐳 Docker / Linux(实验):离线 runtime 只发布 macOS(arm64) / Windows(x64) 两个 payload,没有 Linux payload;

容器里能跑的是 MCP 网关(Python 包 + 知识库 + 记忆),把 HOROSA_SERVER_ROOT / HOROSA_CHART_SERVER_ROOT

指向宿主机或另一台装了 runtime 的机器即可。仓库附带实验性的 horosa-skill/Dockerfile + docker-compose.yml

(网关镜像:容器内没有离线 runtime,必须设上面两个变量;绑 0.0.0.0 必须给 HOROSA_MCP_TOKEN);

手工起也行:pip install "https://github.com/Horace-Maxwell/horosa-skill/releases/download/v0.47.3/horosa_skill-0.47.3-py3-none-any.whl" 后 horosa-skill serve --transport streamable-http 即为网关(PyPI 尚未开通,装的是发布页的 wheel)。

🔧 安装排障与升级 / 卸载

症状处理
uv: command not found先安装 uv:`curl -LsSf https://astral.sh/uv/install.sh \sh`
下载缓慢或中断重跑 install 会断点续传;或设 HOROSA_RUNTIME_MIRROR=<镜像前缀> 走镜像
github.com:443 直连不通(但 api.github.com 可达)——完整方案见 docs/INSTALL_RESTRICTED_NETWORK.md走 API 资产直链下载后本地安装:先 curl -s https://api.github.com/repos/Horace-Maxwell/horosa-skill/releases/latest 找到平台 zip/tar.gz 的 assets[].id,再 curl -L -H "Accept: application/octet-stream" -o runtime.zip https://api.github.com/repos/Horace-Maxwell/horosa-skill/releases/assets/ ,最后 uv run horosa-skill install --archive runtime.zip
Java 后端(:9999)未就绪 / doctor 报 services:java_backend_not_running会自动降级 chart-only 而不是全盘卡死:三式(奇门/太乙/金口)、神数、地占、塔罗、西占 chart 族照常可用;nongli/bazi/ziwei/liureng 与「占时」起课暂不可用。doctor 的 java_diagnostics 附捕获的 Java 启动错误,selfcheck 会自动改用 chart 侧探针
Windows 上 Java 进程秒退、无任何日志已知诱因:代理/VPN/安全软件的 WFP 过滤会拦 java.exe 的 loopback(JDK-17 内部管道优先 AF_UNIX,connect 被拦即崩且无 TCP 回退,见 issue #14)。停掉相关服务通常不够(WFP 过滤驻留内核),需禁用后重启再试;期间 chart-only 降级模式可继续用
磁盘不足 / 端口被占 / 看不懂 doctor 的码uv run horosa-skill doctor --explain:stdout 仍是 JSON,stderr 多 6–10 行人话;报告里 advice[] 给每个 issue / warning 码一句 user_summary + next_action;--probe-network 逐个镜像探清单 URL(默认零外网请求)
macOS 首次起 runtime 失败且无日志 / doctor 报 quarantine:runtime_binaries浏览器下载的归档解出来的 python / java / node 带 Gatekeeper 隔离属性:运行报告里 quarantine.fix 给出的 xattr -dr com.apple.quarantine 后 runtime restart
Windows 路径太长(runtime.install_long_path)doctor.windows.headroom_chars 为负即会拒:设 HOROSA_RUNTIME_ROOT=C:\horosa,或开注册表 LongPathsEnabled=1 后重启(v0.38.0 起临时目录前缀缩短,多出约 20 字符余量)
Windows 上 install 报 runtime.path_not_ascii,或 doctor 报 windows:runtime_root_not_ascii(八字 / 紫微 / 六壬起不来、chart 族报参数错误)runtime 目录路径含中文等非英文字符(中文用户名下的默认路径即是);随包的 Java 17 与 Swiss Ephemeris 用窄字符 API 访问文件。设纯英文路径:setx HOROSA_RUNTIME_ROOT C:\horosa,新开终端并重启 AI 客户端后重跑 install / setup
慢网 / 企业代理下载总超时HOROSA_RUNTIME_DOWNLOAD_TIMEOUT_SECONDS(默认 120)、HOROSA_RUNTIME_DOWNLOAD_ATTEMPTS(默认 3,每个镜像各算一轮);doctor 报 arch.emulated: true 只是提示进程在仿真下跑,不影响安装
Windows 首次启动弹防火墙 / doctor 报 listener:not_loopback_only旧版启动器把 Java 绑在 0.0.0.0;升级后 uv run horosa-skill runtime restart 重套模板即钉回 127.0.0.1(doctor.listener_scope 可核)
Codex 里一堆报错 / 首轮看不到工具多半是超时没写(Codex 默认 10 s/60 s):uv run horosa-skill client check --client codex 会指出缺哪项,client config --format codex --write ~/.codex/config.toml 原位合并修好
终端里 uvx 能跑、GUI 客户端里起不来GUI 客户端不继承 shell PATH;重跑 client config(现在写绝对路径),client check 报 command_not_on_path 即此症
Windows 用户名带空格 / 中文时服务起不来v0.38.0 起启动器给每个路径参数加了引号;升级后 runtime restart
升级uv run horosa-skill upgrade(同版本不重复下载)
卸载uv run horosa-skill uninstall(默认仅打印将删清单,--yes 执行,--purge-data 才动用户数据)

🔌 接入 AI 客户端

setup --client <客户端> 一条命令走完接入(v0.38.0):探网(5 s)→ 装 / 校验离线 runtime →(--vectors 时)准备向量检索 → 写配置(自动定位、 只动 horosa 条目、写前备份 .horosa-bak、原子替换)→ 把 horosa-agent skill 装进该客户端读的 skills 目录(v0.47.3; 多数客户端读共享的 ~/.agents/skills;--no-skill 跳过、--skill-dir 指定)→ doctor → 回读磁盘体检 → 用客户端将要执行的那条命令真起一次 stdio server 并数工具 → 打印下一步。失败时 stderr 给出结构化失败包(step / code / config_untouched / backup_path / retry_command),退出码 2;写配置之前失败保证 config_untouched: true。只想看配置不落盘用 client config:

uv run horosa-skill setup --client cursor                # 🪄 一条命令接入(25 个客户端,见下方 Works with 表)

uv run horosa-skill setup --client cursor --dry-run # 只看计划:零副作用 uv run horosa-skill client config --format claude-code # 只生成不落盘:输出 claude mcp add … 命令 uv run horosa-skill client config --format codex # config.toml 片段(含超时设置) uv run horosa-skill client check # 体检本机各客户端实际写着什么(含 skill 装没装、是不是本版) uv run horosa-skill client skill --client codex # 只装 skill 规则(手动配过 MCP 的用户;不带 --client = 共享目录)

skill 是 agent 读的规则(先问后调 / 只读返回的快照 / 禁手算),此前只有打开本仓的 agent 读得到;wheel 里现在带一份,setup 顺手装好。 已有同名目录时:由 npx skills 等工具以软链接管理的、或不是本工具装的,一律不动;你改过的旧版先备份成 horosa-agent.horosa-bak 再更新。

仓根另带 6 份薄镜像——GEMINI.md(Gemini CLI)、.github/copilot-instructions.md(Copilot)、.windsurf/rules/、 .clinerules/、.cursor/rules/(Cursor)、.agents/skills/horosa-agent/(Codex / agentskills.io)——让这些 agent 打开仓库就知道闸门、读盘规则与精简面下的 horosa_tool_run 直呼;策略唯一源仍是 SKILL.md, 其中「Shell-only agents」一节给没有 MCP 的 agent 一套纯 CLI 契约(tool run --input/--output、退出码、闸门流程)。

Works with
客户端传输一行接入默认工具面注意
🟣 Claude Codestdiosetup --client claude-code(CWD 有 .mcp.json 写项目级,否则自动 claude mcp add --scope user)全量 125项目内直接用仓根 .mcp.json;说明

| 🧩 Claude Code Plugin | stdio | /plugin marketplace add Horace-Maxwell/horosa-skill → /plugin install horosa@horosa-skill | 全量 125 | skill + MCP 一步到位;插件装在 ~/.claude/plugins/cache/horosa-skill/horosa/ /horosa-skill,首次运行 uv run --directory "<那个目录>" horosa-skill install 装离线 runtime(工具报 `runt

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

PopNx에게 묻기