mcpField
E
ephemeris-mcp

ephemeris-mcp

本地服务
github.com/scottchronicity科研与教育431 周前更新
代码仓库

关于 ephemeris-mcp

ephemeris-mcp 是为需要天文位置数据的 AI Agent 和应用提供服务的 MCP 服务。它使用 Swiss Ephemeris，根据指定时间和地点返回 Tropical Zodiac 行星位置及星盘角度。

主要功能

  1. 01基于 Swiss Ephemeris 计算
  2. 02按指定时间查询行星位置
  3. 03支持纬度和经度输入
  4. 04返回 Tropical Zodiac 星座与度数
  5. 05提供上升点和天顶角度

适用场景

  1. 01查询某个时间的行星位置
  2. 02按地点计算星盘角度
  3. 03向 AI Agent 提供天文数据

MCP 相关

它向 MCP 客户端提供 `get_planetary_positions` 工具，可根据指定时间和坐标返回天体及宫位角度。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "scottchronicity-ephemeris": {
      "command": "uvx",
      "args": [
        "ephemeris-mcp"
      ]
    }
  }
}
启动命令uvx ephemeris-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypiephemeris-mcp1.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Ephemeris MCP 🌌

PyPI version CI License: AGPL v3

mcp-name: io.github.scottchronicity/ephemeris-mcp

为 AI Agent 提供精准的天文星历。

Ephemeris MCP 是一个模型上下文协议（MCP）服务，使用 Swiss Ephemeris 为 AI Agent 提供精准的行星位置。

要在 Claude Desktop 中使用，请将以下内容添加到 claude_desktop_config.json：

"mcpServers": {
  "ephemeris": {
    "command": "uvx",
    "args": ["ephemeris-mcp"]
  }
}

快速开始

通过 PyPI 安装（推荐）
# Install with uvx (recommended - fast & isolated, no local install needed)
uvx ephemeris-mcp

# Or install globally with pip
pip install ephemeris-mcp
python -m ephemeris_mcp
在 MCP 客户端中注册

将以下内容添加到 MCP 客户端配置中（客户端会按需启动服务）：

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "uvx",
      "args": ["ephemeris-mcp"]
    }
  }
}

VS Code/Cursor/Windsurf（Cline MCP 设置）：

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "uvx",
      "args": ["ephemeris-mcp"]
    }
  }
}

客户端会自动启动服务进程，通过 stdin/stdout 通信，并在完成后终止该进程。

替代方案：Docker

如果你更倾向于容器隔离：

# Pull latest image
docker pull ghcr.io/scottchronicity/ephemeris-mcp:latest

# Test it
docker run --rm -i ghcr.io/scottchronicity/ephemeris-mcp:latest

使用 Docker 配置 MCP 客户端：

{
  "mcpServers": {
    "ephemeris-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/scottchronicity/ephemeris-mcp:latest"]
    }
  }
}

本地开发

# Clone and install
git clone https://github.com/scottchronicity/ephemeris-mcp.git
cd ephemeris-mcp
uv sync

# Run tests
make test

# Run locally
uv run ephemeris-mcp

# Test the engine directly
make validate-happycase

可用工具

get_planetary_positions

返回所有行星、太阳、月亮和星盘角度的精确热带黄道位置。

参数：

  • iso_time（string）：ISO-8601 时间戳（例如，"2025-12-16T15:28:00Z"）
  • latitude（float）：观测者纬度（默认值：42.3314 - 底特律，密歇根州）
  • longitude（float）：观测者经度（默认值：-83.0458 - 底特律，密歇根州）

返回：

  • bodies：太阳、月亮和行星，包含星座、度数、运动状态（顺行/逆行）、速度和赤纬
  • houses：上升点（ASC）和中天（MC），包含星座和度数

架构

架构决策请参阅 docs/adr/：

  • ADR 001：地心热带黄道坐标规范
  • ADR 002：采用 Conventional Commits 的语义化版本控制
  • ADR 003：CI/CD 流水线架构

许可证

AGPLv3

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。