Astro MCP (Simpolism)

AstroMCP

模型上下文协议（MCP）服务器，为人工智能助手提供占星术图表功能。

](https://badge.fury.io/js/astrology-mcp-server)

🚀 快速开始

1. 克隆存储库
2. 安装依赖项：

   bun install

1. 启动服务器：

   bun run start

✨ 主要特点

• 根据日期、时间和位置生成详细的占星术图表
• 通过模型上下文协议与AI助手无缝集成
• 由...驱动 图表2txt 用于自然语言图表解释
• 使用光子地理编码API进行位置查找
• 输出行星位置、房屋位置和主要方面

📂 项目结构

AstroMCP/
├── src/
│   ├── tools/
│   │   ├── getChart/        # Astrological chart functionality
│   │   └── ...              # Other tools
│   ├── utils/               # Shared utilities
│   ├── main.ts              # Server entry point
│   └── types.ts             # Shared type definitions
├── tests/                   # Test files
├── biome.json               # Linting configuration
├── tsconfig.json            # TypeScript configuration
└── package.json             # Project dependencies

🔮 使用占星术工具

这 get_chart 工具接受三个参数：

• date：YYYY-MM-DD格式的日期
• time：24小时制时间（HH:MM:SS）
• location：“城市、国家”格式的位置

示例响应：

Astrology Chart (location: New York, USA, at: 1/1/2001, 1:01:00 AM):

Ascendant is at 21° Libra. Sun is at 10° Capricorn. Moon is at 21° Pisces. Mercury is at 14° Capricorn. Venus is at 27° Aquarius. Mars is at 5° Scorpio. Jupiter is at 2° Gemini. Saturn is at 24° Taurus. Uranus is at 18° Aquarius. Neptune is at 5° Aquarius. Pluto is at 13° Sagittarius.

Sun is in house 4. Moon is in house 6. Mercury is in house 4. Venus is in house 5. Mars is in house 2. Jupiter is in house 9. Saturn is in house 8. Uranus is in house 5. Neptune is in house 5. Pluto is in house 3.

Sun is in conjunction with Mercury (orb: 3.8°). Moon is in sextile with Saturn (orb: 2.8°). Venus is in square with Jupiter (orb: 4.9°). Venus is in square with Saturn (orb: 2.7°). Mars is in square with Neptune (orb: 0.3°). Jupiter is in trine with Neptune (orb: 3.2°).

⚙️ 配置

API终点

服务器使用以下API终结点：

• 用于地理编码位置的Photon API（Photon.komout.io）
• 简单Astro API 用于行星计算（目前使用托管版本）

创建新工具

该项目包括一个脚本，用于帮助创建新的MCP工具：

bun run scripts/create-tool.ts 

🛠️ 发展

• 运行测试: bun test
• 格式代码: bun run format
• Lint代码: bun run lint
• 生成项目: bun run build

要将AstroMCP服务器添加到Claude Desktop，请执行以下操作：

1. 构建项目：

   bun run build

1. 添加到您的Claude Desktop配置中：

   {
     "mcpServers": {
       "astrology-mcp-server": {
         "command": "/path/to/node",
         "args": ["/path/to/AstroMCP/dist/main.js"]
       }
     }
   }

📦 发布到npm

1. 请确保您已登录到npm：

   npm login

1. 构建项目：

   bun run build

1. 发布包：

   npm publish

从npm安装（发布后）

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "astro-server": {
      "command": "npx",
      "args": ["-y", "astrology-mcp-server"]
    }
  }
}