Ziwei Ai
About
紫微AI，是一个紫微斗数解盘AI应用。Ziwei AI is an AI application for Ziwei Doushu chart interpretation.紫微AIは、紫微斗数のチャート解読のためのAIアプリケーションです。
Details
- Author
- Timmy9527
- GitHub stars
- 8
- Downloads
- 166
- Categories
- Other
Jump to
- List purchased reports via list_my_reports tool.
- List report type codes (ming, ln, lc, ll, lr, cp, dh) via list_report_types.
- Get polished report content with optional language parameter.
- Generate payment links for unpurchased report types.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ziwei AiCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the npm package (npm install ziweiai-mcp-server) or run directly with npx ziweiai-mcp-server. Obtain an MCP API Key from the Ziwei Ai website, set the environment variable ZIWEIAI_MCP_API_KEY, and start the server. For Cursor, add the server configuration in ~/.cursor/mcp.json or through Cursor Settings.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ziwei ai": {
"ziweiai": {
"command": "node",
"args": [
"/data/ziweiai/mcp-server/dist/index.js"
],
"env": {
"ZIWEIAI_MCP_API_KEY": "Paste the API key you generated and copied from \"My Reports\" here"
}
}
}
}
}McpServers
{
"ziweiai": {
"command": "node",
"args": [
"/data/ziweiai/mcp-server/dist/index.js"
],
"env": {
"ZIWEIAI_MCP_API_KEY": "Paste the API key you generated and copied from \"My Reports\" here"
}
}
}ZiweiAI MCP Server
中文说明见 README.zh-CN.md。
MCP (Model Context Protocol) server for ZiweiAI reports. Use it in Cursor, Claude Desktop, or other MCP clients to list your reports, get polished report content, and get payment links.
Repository: https://github.com/Timmy9527/agentziwei
Installation
Option A – use the published npm package (recommended):
npm install ziweiai-mcp-server
Or run directly without installing (requires Node.js ≥18):
npx ziweiai-mcp-server
Option B – build from source (clone the repo):
cd mcp-server
npm install
npm run build
Prerequisites
1. MCP API Key: Log in at ziweiai.com or ziweiai.com.cn, go to My Reports, find MCP Integration, and click Generate MCP API Key. Copy the key (it is shown only once).
2. Reports: Purchase reports on the website first; MCP can only list purchased reports and fetch their content.
Environment
| Variable | Required | Description |
|----------|----------|-------------|
| ZIWEIAI_MCP_API_KEY | Yes | Your MCP API key from the website. |
| ZIWEIAI_API_BASE | No | API base URL (default: https://ziweiai.com). Use https://ziweiai.com.cn if your account/reports are on the Chinese site. |
Run
If you installed via npm:
export ZIWEIAI_MCP_API_KEY="your-key-here"
npx ziweiai-mcp-server
Or with the global bin (after npm install -g ziweiai-mcp-server):
export ZIWEIAI_MCP_API_KEY="your-key-here"
ziweiai-mcp
If you built from source:
export ZIWEIAI_MCP_API_KEY="your-key-here"
node dist/index.js
Or with tsx (no build): ZIWEIAI_MCP_API_KEY="your-key" npx tsx src/index.ts
Cursor configuration
Add to Cursor MCP settings (e.g. ~/.cursor/mcp.json or Cursor Settings → Features → MCP):
Using the npm package (recommended):
{
"mcpServers": {
"ziweiai": {
"command": "npx",
"args": ["-y", "ziweiai-mcp-server"],
"env": {
"ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
}
}
}
}
-y makes npx use the package without prompting. Replace your-mcp-api-key with your key.
Using a local build (clone the repo first):
{
"mcpServers": {
"ziweiai": {
"command": "node",
"args": ["/path/to/ziweiai/mcp-server/dist/index.js"],
"env": {
"ZIWEIAI_MCP_API_KEY": "your-mcp-api-key"
}
}
}
}
Replace /path/to/ziweiai with the real path.
Tools
- list_my_reports – List your purchased reports (consumer list).
- list_report_types – List report type codes (ming, ln, lc, ll, lr, cp, dh).
- get_report_content – Get polished report content (pass generate params + language).
- get_payment_link – Get URL to purchase a report on the website (query param: paper).
List reports API (GET/POST /api/mcp/reports)
- Auth: Header X-MCP-API-Key with your MCP API Key.
- Query params (optional): format=human (return human-readable fields), lang=zh or lang=en (default en when format=human). Without format, the API returns the raw array.
- When format=human, each item includes reportType, queryInfo, reportPath (same semantics as the website “My reports” page). binddate in raw data is a concatenated string; invalid or empty values are handled safely and do not throw.
Payment
Payment is always done on the website. MCP only lists purchased reports, returns polished content for them, and provides payment links for report types you have not purchased.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
