psrmcp 0.1.0__tar.gz

psrmcp-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+dist/
+build/
+
+# Tooling
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Editors
+.idea/
+.vscode/
+*.swp
+
+# Local runtime state
+*.log
+.claude/settings.local.json
+config.toml
+ws/

psrmcp-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,58 @@
+# CI:单元测试 + PyPI 自动发布(PyPI Trusted Publishing / OIDC,CI 中无长期 token)。
+#
+# 首次发布前的一次性设置(pypi.org):
+#   登录 → Account settings → Publishing → Add a new pending publisher
+#     PyPI project name:  psrmcp
+#     Pending publisher:  GitLab CI/CD
+#     Owner (namespace):  zhangyazhou416
+#     Repository name:    psrmcp
+#     Workflow filename:  .gitlab-ci.yml
+# (项目首次发布成功后,改在项目页 Project settings → Publishing 管理)
+#
+# 发布方式:打 tag 即自动构建上传
+#   git tag v0.1.0 && git push origin v0.1.0
+# (注意保持 tag 与 pyproject.toml 的 version 一致;PyPI 禁止同版本重传)
+
+stages:
+  - test
+  - publish
+
+unit-tests:
+  stage: test
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+  cache:
+    key:
+      files:
+        - uv.lock
+    paths:
+      - .venv/
+  script:
+    - uv sync
+    - uv run pytest tests/unit -q
+
+publish-pypi:
+  stage: publish
+  image: ghcr.io/astral-sh/uv:python3.12-bookworm
+  id_tokens:
+    PYPI_ID_TOKEN:          # GitLab OIDC ID token;aud 必须为 pypi
+      aud: pypi
+  script:
+    - uv build
+    # 用 OIDC ID token 向 PyPI 换一次性上传 token(UV_PUBLISH_TOKEN 为 uv publish 认可)
+    - |
+      cat > /tmp/mint_token.py <<'PY'
+      import json, os, urllib.request
+
+      req = urllib.request.Request(
+          "https://pypi.org/_/oidc/mint-token",
+          data=json.dumps({"token": os.environ["PYPI_ID_TOKEN"]}).encode(),
+          headers={"Content-Type": "application/json"},
+      )
+      with urllib.request.urlopen(req) as resp:
+          print(json.load(resp)["token"])
+      PY
+      export UV_PUBLISH_TOKEN="$(python3 /tmp/mint_token.py)"
+      uv publish
+  rules:
+    - if: $CI_COMMIT_TAG    # 仅打 tag 时发布;tag 也可在 GitLab 页面手动跑此 job
+      when: on_success

psrmcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

psrmcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhangyazhou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

psrmcp-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.5
+Name: psrmcp
+Version: 0.1.0
+Summary: MCP server wrapping pulsar astronomy software (dspsr, psrchive, tempo2, psrcat, PINT)
+Project-URL: Repository, https://gitlab.com/zhangyazhou416/psrmcp
+Project-URL: Issues, https://gitlab.com/zhangyazhou416/psrmcp/-/issues
+Author: psrmcp contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: astropy<9,>=8.0
+Requires-Dist: matplotlib<4,>=3.11
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: numpy<3,>=2.1
+Requires-Dist: pint-pulsar<2,>=1.1
+Requires-Dist: psrqpy<2,>=1.3
+Requires-Dist: pydantic<3,>=2.14
+Description-Content-Type: text/markdown
+
+# psrmcp
+
+把脉冲星天文软件链(dspsr / psrchive / tempo2 / psrcat / PINT)封装成 MCP(Model Context Protocol)Server:面向任务的工具、参数受控、结果结构化、全程可追溯。
+
+仓库:<https://gitlab.com/zhangyazhou416/psrmcp>
+
+- 功能总览:[docs/FEATURES.md](docs/FEATURES.md)(能做什么、19 个工具一览)
+- 使用教程:[docs/TUTORIAL.md](docs/TUTORIAL.md)(安装配置、接入客户端、完整处理链实战)
+- 设计方案:[docs/DESIGN.md](docs/DESIGN.md)
+- 工具契约:[docs/TOOLS.md](docs/TOOLS.md)(19 个工具的输入/输出 Schema)
+- 一键安装脉冲星软件栈:[scripts/install_pulsar_stack.sh](scripts/install_pulsar_stack.sh)(全源码编译进 `~/.pulsar`,详见 [docs/INSTALL.md](docs/INSTALL.md))
+
+## 快速开始
+
+```bash
+# 1. 安装脉冲星软件栈(可选,缺省时服务器会优雅降级并在 pulsar_environment 中报告)
+bash scripts/install_pulsar_stack.sh          # 加 --with-presto 连 PRESTO 一起装
+
+# 2. 准备 MCP 服务器环境
+uv sync
+
+# 3. 生成默认配置并启动(stdio)
+uv run psrmcp --init-config ~/.psrmcp.toml
+PSRMCP_CONFIG=~/.psrmcp.toml uv run psrmcp
+```
+
+### 接入 MCP 客户端(如 Claude Code / Desktop)
+
+```json
+{
+  "mcpServers": {
+    "psrmcp": {
+      "command": "uv",
+      "args": ["--directory", "/path/to/psrmcp", "run", "psrmcp"],
+      "env": {"PSRMCP_CONFIG": "~/.psrmcp.toml"}
+    }
+  }
+}
+```
+
+## 开发
+
+```bash
+uv run pytest -q                        # 单元测试(不需要安装任何后端)
+PSRMCP_CONTRACT=1 uv run pytest tests/contract   # 契约测试(需要已安装软件栈)
+```
+
+## 发布到 PyPI
+
+CI 自动发布([.gitlab-ci.yml](.gitlab-ci.yml),PyPI Trusted Publishing / OIDC,CI 中无长期凭据):
+
+```bash
+git tag v0.1.0 && git push origin v0.1.0    # 打 tag 即构建并上传(tag 与 version 保持一致)
+```
+
+首次发布前需在 pypi.org 登记 pending publisher(Owner `zhangyazhou416`、Repository `psrmcp`、Workflow `.gitlab-ci.yml`),见 CI 文件顶部注释。手动发布:`uv build && uv publish`。
+
+## 状态
+
+v0.1.0 — MVP(Phase 0–2):环境自检、数据发现、星表查询、archive 检查/转换/合并、消色散、RFI、标准轮廓、TOA、PINT 计时拟合与诊断。
+
+## 许可
+
+[MIT](LICENSE)

psrmcp-0.1.0/README.md

@@ -0,0 +1,64 @@
+# psrmcp
+
+把脉冲星天文软件链(dspsr / psrchive / tempo2 / psrcat / PINT)封装成 MCP(Model Context Protocol)Server:面向任务的工具、参数受控、结果结构化、全程可追溯。
+
+仓库:<https://gitlab.com/zhangyazhou416/psrmcp>
+
+- 功能总览:[docs/FEATURES.md](docs/FEATURES.md)(能做什么、19 个工具一览)
+- 使用教程:[docs/TUTORIAL.md](docs/TUTORIAL.md)(安装配置、接入客户端、完整处理链实战)
+- 设计方案:[docs/DESIGN.md](docs/DESIGN.md)
+- 工具契约:[docs/TOOLS.md](docs/TOOLS.md)(19 个工具的输入/输出 Schema)
+- 一键安装脉冲星软件栈:[scripts/install_pulsar_stack.sh](scripts/install_pulsar_stack.sh)(全源码编译进 `~/.pulsar`,详见 [docs/INSTALL.md](docs/INSTALL.md))
+
+## 快速开始
+
+```bash
+# 1. 安装脉冲星软件栈(可选,缺省时服务器会优雅降级并在 pulsar_environment 中报告)
+bash scripts/install_pulsar_stack.sh          # 加 --with-presto 连 PRESTO 一起装
+
+# 2. 准备 MCP 服务器环境
+uv sync
+
+# 3. 生成默认配置并启动(stdio)
+uv run psrmcp --init-config ~/.psrmcp.toml
+PSRMCP_CONFIG=~/.psrmcp.toml uv run psrmcp
+```
+
+### 接入 MCP 客户端(如 Claude Code / Desktop)
+
+```json
+{
+  "mcpServers": {
+    "psrmcp": {
+      "command": "uv",
+      "args": ["--directory", "/path/to/psrmcp", "run", "psrmcp"],
+      "env": {"PSRMCP_CONFIG": "~/.psrmcp.toml"}
+    }
+  }
+}
+```
+
+## 开发
+
+```bash
+uv run pytest -q                        # 单元测试(不需要安装任何后端)
+PSRMCP_CONTRACT=1 uv run pytest tests/contract   # 契约测试(需要已安装软件栈)
+```
+
+## 发布到 PyPI
+
+CI 自动发布([.gitlab-ci.yml](.gitlab-ci.yml),PyPI Trusted Publishing / OIDC,CI 中无长期凭据):
+
+```bash
+git tag v0.1.0 && git push origin v0.1.0    # 打 tag 即构建并上传(tag 与 version 保持一致)
+```
+
+首次发布前需在 pypi.org 登记 pending publisher(Owner `zhangyazhou416`、Repository `psrmcp`、Workflow `.gitlab-ci.yml`),见 CI 文件顶部注释。手动发布:`uv build && uv publish`。
+
+## 状态
+
+v0.1.0 — MVP(Phase 0–2):环境自检、数据发现、星表查询、archive 检查/转换/合并、消色散、RFI、标准轮廓、TOA、PINT 计时拟合与诊断。
+
+## 许可
+
+[MIT](LICENSE)