zhenyun-pangun-mcp

zhenyun-pangun-mcp

Enables querying logs across Loki/SLS, querying databases via Archery, accessing Choerodon project collaboration tools, and searching local code repositories through a unified MCP interface with self-contained configuration.

Category
Visit Server

README

zhenyun-pangun-mcp

甄云盘古通用工具 MCP，供任意 MCP 客户端（Claude Desktop / Cursor / 各类 agent）复用。

完全自包含：不依赖任何外部项目目录，仅需在 .env 配置真实凭据即可使用。

能力总览

工具按前缀分组（共 17 个）：

前缀 工具 说明
obs_* obs_log_query / obs_log_datasources / obs_sls_query 日志查询：Loki 双平台（aws 海外全环境 + cn 国内非生产）+ 阿里云 SLS（仅 cn 国内盘古 prod）
archery_* archery_query / archery_describe_table / archery_list_columns / archery_query_tenant / archery_list_databases / archery_list_instances 数据库查询（Archery 双站点 cn/aws + 盘古专属租户/库/实例能力）
choerodon_* choerodon_query_issue / choerodon_list_issue / choerodon_search_users / choerodon_get_status_map / choerodon_search_tasks_by_person / choerodon_list_attachments / choerodon_download_attachment 猪齿鱼协作（内置 Python 客户端，纯 HTTP 登录）
search_repo search_repo 跨本地代码仓库搜索（内容 / 文件名 / 模块结构）

日志平台区分（重要）

盘古日志分布在三个不同平台，查询前需先确认目标环境落在哪个平台：

能力 环境 平台 数据源 / project 标签体系
obs_log_query AWS 海外（全部环境） Grafana/Loki Jp-saas-1-prod / Jp-saas-1-noneprod / ops job / app
obs_log_query cn 国内非生产（dev/test） Grafana/Loki Loki (pangu-noneprod) 等 namespace / service_name / pod_name / container_name
obs_sls_query 仅 cn 国内盘古 prod 阿里云 SLS pangu-cn-saas-3-prod-shared-sls-project-0 / sls-store-0-pangu-prod _namespace_ = saas-prod
  • cn 国内盘古 prod 日志 = 阿里云 SLS（对接方式复刻自 log-ops-mcp），用 obs_sls_query 查询。
  • cn 国内盘古 dev/test 等非生产用 obs_log_query(region="cn")，盘古非生产面板（namespace=saas-dev-new / saas-test-new）日志在 Loki (pangu-noneprod) 数据源。
  • **AWS 海外（无论 prod/非生产）**全部用 obs_log_query(region="aws")。
  • ⚠️ 路由铁律：除 cn 国内盘古 prod 走 SLS 外，其余（cn 非生产 + 全部 AWS）都走 Loki。盘古非生产不要调 obs_sls_query。

三个平台的登录凭据、数据源名均在 .env 独立配置，详见 .env.example。

安装与运行

cd zhenyun-pangun-mcp
uv sync  # 或 pip install -e .
cp .env.example .env   # 填写真实凭据

以 stdio 运行：

uv run zhenyun-pangun-mcp
# 或
python -m zhenyun_pangun_mcp

MCP 客户端配置

{
  "mcpServers": {
    "zhenyun-pangun-mcp": {
      "command": "uvx",
      "args": ["--from", "/path/to/zhenyun-pangun-mcp", "zhenyun-pangun-mcp"],
      "env": {
        "MCP_ENV_DIR": "/path/to/zhenyun-pangun-mcp"
      }
    }
  }
}

配置项（.env）

分组 环境变量 说明
Archery ARCHERY_USERNAME / ARCHERY_PASSWORD / ARCHERY_AWS_USERNAME / ARCHERY_AWS_PASSWORD 数据库网关 cn/aws 凭据
ARCHERY_DB_CN / ARCHERY_DB_AWS / ARCHERY_DB_DEV / ARCHERY_DB_TEST 实例别名 → 真实实例名
Loki AWS_LOG_USERNAME / AWS_LOG_PASSWORD / CN_LOG_USERNAME / CN_LOG_PASSWORD Grafana 登录凭据
AWS_LOG_DS_* / CN_LOG_DS_* 环境 → 数据源名映射
Choerodon CHOERODON_BASE_URL / CHOERODON_USERNAME / CHOERODON_PASSWORD 猪齿鱼网关与登录凭据
SLS SLS_PANGU_PROD_ACCESS_KEY_ID / SLS_PANGU_PROD_ACCESS_KEY_SECRET 盘古正式环境阿里云日志凭据
其他 PG_ROOT 跨仓搜索根目录（默认本仓库根）

凭据请勿提交 git；.env 已由 .gitignore 排除，仅 .env.example（占位符版）入库。

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured