mcp-apollo-explorer 0.1.0__tar.gz

mcp_apollo_explorer-0.1.0/.idea/.gitignore

@@ -0,0 +1,5 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/

mcp_apollo_explorer-0.1.0/.idea/encodings.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding" addBOMForNewFiles="with BOM under Windows, with no BOM otherwise" />
+</project>

mcp_apollo_explorer-0.1.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,12 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyStubPackagesAdvertiser" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredPackages">
+        <list>
+          <option value="pandas" />
+        </list>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

mcp_apollo_explorer-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

mcp_apollo_explorer-0.1.0/.idea/mcp-apollo-explorer.iml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module external.system.id="pyproject.toml" type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="uv (mcp_apollo_explorer)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+</module>

mcp_apollo_explorer-0.1.0/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="uv (mcp_apollo_explorer)" />
+  </component>
+</project>

mcp_apollo_explorer-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/mcp-apollo-explorer.iml" filepath="$PROJECT_DIR$/.idea/mcp-apollo-explorer.iml" />
+    </modules>
+  </component>
+</project>

mcp_apollo_explorer-0.1.0/.idea/pyProjectModel.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PyProjectModelSettings">
+    <option name="showConfigurationNotification" value="false" />
+    <option name="usePyprojectToml" value="true" />
+  </component>
+</project>

mcp_apollo_explorer-0.1.0/.idea/workspace.xml

@@ -0,0 +1,188 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="0e28e81a-c2ac-4074-add8-dcf66e85c164" name="更改" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 8,
+  &quot;fromUser&quot;: false
+}</component>
+  <component name="ProjectId" id="3Gd4sHqTcMbQSggMtEdREUKslfm" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;Python 测试.tests.test_apollo_client.test_list_namespaces_ok 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_apollo_client.test_missing_cookie_raises 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_change_history_user_filter_real 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_change_history_xml_parent_paths_real 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_diff_commit 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_fetch_commits_desc_by_time 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_fetch_releases_desc_by_time 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_get_namespace_content 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_get_namespace_content_xml 的 Python 测试.executor&quot;: &quot;Debug&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_list_namespaces_returns_non_empty_list 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;Python 测试.tests.test_real_apollo.test_release_base_info_fields 的 Python 测试.executor&quot;: &quot;Run&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
+    &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
+    &quot;ignore.virus.scanning.warn.message&quot;: &quot;true&quot;,
+    &quot;last_opened_file_path&quot;: &quot;D:/Coding/mcp-server/mcp_apollo_explorer&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
+    &quot;settings.editor.selected.configurable&quot;: &quot;preferences.customizations&quot;
+  }
+}</component>
+  <component name="RunManager" selected="Python 测试.tests.test_real_apollo.test_change_history_xml_parent_paths_real 的 Python 测试">
+    <configuration name="tests.test_real_apollo.test_change_history_user_filter_real 的 Python 测试" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="mcp-apollo-explorer" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <option name="RUN_TOOL" value="" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;tests.test_real_apollo.test_change_history_user_filter_real&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <configuration name="tests.test_real_apollo.test_change_history_xml_parent_paths_real 的 Python 测试" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="mcp-apollo-explorer" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <option name="RUN_TOOL" value="" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;tests.test_real_apollo.test_change_history_xml_parent_paths_real&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <configuration name="tests.test_real_apollo.test_diff_commit 的 Python 测试" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="mcp-apollo-explorer" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <option name="RUN_TOOL" value="" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;tests.test_real_apollo.test_diff_commit&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <configuration name="tests.test_real_apollo.test_fetch_commits_desc_by_time 的 Python 测试" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="mcp-apollo-explorer" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <option name="RUN_TOOL" value="" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;tests.test_real_apollo.test_fetch_commits_desc_by_time&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <configuration name="tests.test_real_apollo.test_list_namespaces_returns_non_empty_list 的 Python 测试" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="mcp-apollo-explorer" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <option name="RUN_TOOL" value="" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;tests.test_real_apollo.test_list_namespaces_returns_non_empty_list&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python 测试.tests.test_real_apollo.test_change_history_xml_parent_paths_real 的 Python 测试" />
+        <item itemvalue="Python 测试.tests.test_real_apollo.test_diff_commit 的 Python 测试" />
+        <item itemvalue="Python 测试.tests.test_real_apollo.test_list_namespaces_returns_non_empty_list 的 Python 测试" />
+        <item itemvalue="Python 测试.tests.test_real_apollo.test_change_history_user_filter_real 的 Python 测试" />
+        <item itemvalue="Python 测试.tests.test_real_apollo.test_fetch_commits_desc_by_time 的 Python 测试" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-c59985aa861c-c2ffad84badb-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-261.24374.152" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="默认任务">
+      <changelist id="0e28e81a-c2ac-4074-add8-dcf66e85c164" name="更改" comment="" />
+      <created>1784288318301</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1784288318301</updated>
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="XDebuggerManager">
+    <breakpoint-manager>
+      <breakpoints>
+        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
+          <url>file://$PROJECT_DIR$/tests/test_real_apollo.py</url>
+          <line>66</line>
+          <option name="timeStamp" value="6" />
+        </line-breakpoint>
+        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
+          <url>file://$PROJECT_DIR$/tests/test_real_apollo.py</url>
+          <line>93</line>
+          <option name="timeStamp" value="7" />
+        </line-breakpoint>
+        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
+          <url>file://$PROJECT_DIR$/tests/test_real_apollo.py</url>
+          <line>121</line>
+          <option name="timeStamp" value="8" />
+        </line-breakpoint>
+        <line-breakpoint enabled="true" suspend="THREAD" type="python-line">
+          <url>file://$PROJECT_DIR$/tests/test_real_apollo.py</url>
+          <line>119</line>
+          <option name="timeStamp" value="9" />
+        </line-breakpoint>
+      </breakpoints>
+    </breakpoint-manager>
+  </component>
+</project>

mcp_apollo_explorer-0.1.0/CLAUDE.md

@@ -0,0 +1,36 @@
+# mcp-apollo-explorer
+
+基于 cookie 认证查询 Apollo 配置中心的 MCP 服务（Python）。
+
+## 技术约束
+- Python 3.10+，全类型注解
+- 依赖最小化：`mcp`（官方 SDK）、`httpx`；`difflib`、`xml.parsers.expat` 用标准库
+- 不引入 web 框架、不引入 ORM
+
+## 三个工具
+1. `apollo_change_history` - 查变更历史（入参 app_ids 列表 + since，可选 until 截止时间 / user 筛改动人；基于 commit，user 筛改动人）
+2. `apollo_list_namespaces` - 根据 appId 查 namespace 数量/列表
+3. `apollo_get_namespace_content` - 根据 appId+namespace 查当前内容
+
+## 配置（环境变量）
+- `APOLLO_COOKIE`（必需）：Portal 登录 cookie 整段值
+- `APOLLO_PORTAL_URL`（可选，默认 `http://config-portal.beisencorp.com`）
+- env / cluster 作为工具参数，默认 `DEV` / `default`
+
+## 编码规范
+- 工具返回结构化 JSON（dict / list），不返回大段文本
+- 行 diff 用 `difflib`，输出 `{type, key, old_lines, new_lines, parent_paths}`；xml 文件型 namespace 的 `parent_paths` 为改动行所属 xml 元素的父路径（expat 按行号定位，如 `/root/config`），非 xml 为空列表
+- 错误处理：cookie 失效（登录页检测）、网络超时、分页截断标注 `truncated`
+- 安全：cookie 与配置值一律不得写入日志或异常消息
+- 所有 HTTP 请求统一走 `apollo_client.py`，带 `Cookie` + `Accept: application/json`
+
+## Apollo API（已验证路径）
+- namespace 列表：`GET /apps/{appId}/envs/{env}/clusters/{cluster}/namespaces`
+- namespace 详情：`GET /apps/{appId}/envs/{env}/clusters/{cluster}/namespaces/{ns}`（返回完整 items；xml/json/yaml 等文件型 namespace 的 list 接口不回填 items，需走此详情接口）
+- 提交历史：`GET /apps/{appId}/envs/{env}/clusters/{cluster}/namespaces/{ns}/commits?page={n}&size=200`
+- commit 结构：`{dataChangeCreatedBy,dataChangeCreatedTime,changeSets}`，按时间倒序（[0] 最新）；`changeSets` 为 JSON 字符串（xml/文件型 namespace 实测）或 dict，解析后 `{createItems,updateItems,deleteItems}`，item 为 `{oldItem,newItem}`（各含 `{key,value}`）
+
+## 开发
+- `uv sync` 装依赖
+- `uvx --from . mcp-apollo-explorer` 本地跑
+- 测试用真实 cookie 验证 3 个工具

mcp_apollo_explorer-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: mcp-apollo-explorer
+Version: 0.1.0
+Summary: MCP server for exploring Apollo config center (history/namespace/content) via cookie auth
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.2.0

mcp_apollo_explorer-0.1.0/README.md

@@ -0,0 +1,88 @@
+# mcp-apollo-explorer
+
+基于 cookie 认证查询 Apollo 配置中心（携程开源版）的 MCP 服务（Python）。
+
+提供 3 个工具：
+
+1. `apollo_change_history` - 查变更历史（入参 app_ids 列表 + since，可选 user 筛发布人）
+2. `apollo_list_namespaces` - 根据 appId 查 namespace 数量/列表
+3. `apollo_get_namespace_content` - 根据 appId + namespace 查当前内容
+
+## 依赖
+- Python 3.10+
+- Apollo Portal（携程开源版），需能通过浏览器登录拿到 cookie
+
+## 安装
+```bash
+cd D:/Coding/mcp-server
+uv sync
+```
+
+## 配置（环境变量）
+| 变量 | 必需 | 说明 |
+|------|------|------|
+| `APOLLO_COOKIE` | 是 | Portal 登录后的 cookie 整段值 |
+| `APOLLO_PORTAL_URL` | 否 | Portal 地址，默认 `http://config-portal.beisencorp.com` |
+
+### 获取 cookie
+1. 浏览器登录 Apollo Portal
+2. F12 -> Network -> 点任意请求 -> Request Headers 复制 `Cookie:` 整段值
+3. 去掉 `Cookie:` 前缀，只留值
+
+> cookie 是登录态，等同账号权限，注意保密。失效后重新导出即可（无需账号密码）。
+
+## MCP 配置（.claude.json）
+```json
+{
+  "mcpServers": {
+    "apollo-explorer": {
+      "command": "uvx",
+      "args": ["--from", "D:/Coding/mcp-server", "mcp-apollo-explorer"],
+      "env": {
+        "APOLLO_COOKIE": "<粘贴 cookie 值>"
+      }
+    }
+  }
+}
+```
+
+## 工具说明
+
+### apollo_list_namespaces
+根据 appId 查 namespace 数量与列表。
+参数：`app_id`（必填）、`env="DEV"`、`cluster="default"`
+返回：`{app_id, env, cluster, count, namespaces:[name,...]}`
+
+### apollo_get_namespace_content
+根据 appId + namespace 查当前配置内容。
+参数：`app_id`、`namespace`（必填）、`env="DEV"`、`cluster="default"`
+返回：`{app_id, namespace, env, cluster, format, items:[{key,value}]}`
+
+### apollo_change_history
+查变更历史：按 appId 列表查指定时间起的发布，每次发布含行级 diff。
+参数：
+- `app_ids: list[str]`（必填）
+- `since: str`（必填，ISO 日期如 `2026-06-07`）
+- `env="DEV"`、`cluster="default"`
+- `user: str | None`（可选，按发布人 userId 过滤）
+- `max_releases_per_namespace=500`
+
+返回每个匹配发布的 `changes`：`{key, type:added|removed|modified, old_lines, new_lines}`，多行配置（如 XML）按行 diff，只返回变化的行。
+
+> 在「谁改谁发」的环境下，发布人 = 修改人。若存在「你改别人发」，发布人维度会漏，需用 DB 查 commit。
+
+## 本地调试
+```bash
+uv run mcp-apollo-explorer                              # 启动 stdio server
+uv run mcp dev src/mcp_apollo_explorer/server.py        # MCP inspector
+```
+
+cookie 失效会报 `ApolloAuthError: Apollo returned login page...`，重新导出 cookie 即可。
+
+## 项目结构
+```
+src/mcp_apollo_explorer/
+  server.py        # FastMCP + 3 工具 + main
+  apollo_client.py # Portal API（cookie 认证、分页、登录页检测）
+  diff.py          # difflib 行级 diff
+```

mcp_apollo_explorer-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "mcp-apollo-explorer"
+version = "0.1.0"
+description = "MCP server for exploring Apollo config center (history/namespace/content) via cookie auth"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]>=1.2.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+mcp-apollo-explorer = "mcp_apollo_explorer.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_apollo_explorer"]
+
+[dependency-groups]
+dev = ["pytest>=8.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

mcp_apollo_explorer-0.1.0/scripts/probe.py

@@ -0,0 +1,132 @@
+"""真实请求 Apollo 探测脚本:跑通三个工具并打印返回值。
+
+用法:
+    # 先把整段 cookie 放进环境变量(三种方式任选其一)
+    export APOLLO_COOKIE='你的cookie整段'          # 当前 shell
+    # 或一次性前缀:
+    APOLLO_COOKIE='...' uv run python scripts/probe.py <app_id>
+    # 或写到系统环境变量后重启终端
+
+    uv run python scripts/probe.py <app_id> [--env DEV] [--cluster default] [--namespace NS] [--full]
+
+安全:
+    - cookie 仅从环境变量读取,绝不打印。
+    - 配置 value / diff 行默认脱敏(只显示字符数),--full 才显示明文。
+      明文可能含密钥,如需贴回对话请用默认脱敏模式。
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from mcp_apollo_explorer.apollo_client import ApolloAuthError, ApolloClient
+
+
+def mask(v: object, full: bool) -> object:
+    if full or v is None:
+        return v
+    return f"<{len(str(v))} chars>"
+
+
+def mask_items(items: list[dict], full: bool) -> list[dict]:
+    return [{"key": i.get("key"), "value": mask(i.get("value"), full)} for i in items]
+
+
+def mask_changes(changes: list[dict], full: bool) -> list[dict]:
+    return [
+        {
+            "key": c["key"],
+            "type": c["type"],
+            "old_lines": [mask(l, full) for l in c["old_lines"]],
+            "new_lines": [mask(l, full) for l in c["new_lines"]],
+        }
+        for c in changes
+    ]
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(description="Apollo 真实探测")
+    ap.add_argument("app_id")
+    ap.add_argument("--env", default="DEV")
+    ap.add_argument("--cluster", default="default")
+    ap.add_argument("--namespace", default=None, help="指定 namespace,默认取列表第一个")
+    ap.add_argument("--full", action="store_true", help="显示配置明文(默认脱敏)")
+    ap.add_argument("--releases", type=int, default=5, help="拉取的 release 条数,默认 5")
+    args = ap.parse_args()
+
+    try:
+        client = ApolloClient()
+    except ApolloAuthError as e:
+        print(f"[auth] {e}", file=sys.stderr)
+        print("请先设置 APOLLO_COOKIE 环境变量。", file=sys.stderr)
+        sys.exit(2)
+
+    print(f"portal : {client.portal_url}")
+    print(f"cookie : <set, {len(client.cookie)} chars>")
+    print(f"app_id : {args.app_id}  env={args.env}  cluster={args.cluster}  full={args.full}")
+    print("=" * 70)
+
+    # 1. list_namespaces
+    print("\n[1] list_namespaces")
+    try:
+        ns_list = client.list_namespaces(args.app_id, args.env, args.cluster)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+    names = [client._ns_name(n) for n in ns_list]
+    print(json.dumps({"count": len(names), "namespaces": names}, ensure_ascii=False, indent=2))
+    if not names:
+        print("无 namespace,结束。")
+        return
+    ns = args.namespace or names[0]
+
+    # 2. get_namespace_content
+    print(f"\n[2] get_namespace_content  namespace={ns}")
+    try:
+        content = client.get_namespace_content(args.app_id, ns, args.env, args.cluster)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ERROR: {e}", file=sys.stderr)
+    else:
+        view = {k: content.get(k) for k in ("app_id", "namespace", "env", "cluster", "format")}
+        view["items"] = mask_items(content.get("items") or [], args.full)
+        print(json.dumps(view, ensure_ascii=False, indent=2))
+
+    # 3. fetch_releases
+    print(f"\n[3] fetch_releases  namespace={ns}  max={args.releases}")
+    try:
+        rels = client.fetch_releases(
+            args.app_id, ns, args.env, args.cluster, max_releases=args.releases
+        )
+    except Exception as e:  # noqa: BLE001
+        print(f"  ERROR: {e}", file=sys.stderr)
+        return
+    print(f"  共 {len(rels)} 条 (倒序,[0] 最新)")
+    for idx, r in enumerate(rels[: args.releases]):
+        b = r.get("baseInfo") or {}
+        items = r.get("items") or []
+        print(
+            f"  [{idx}] {b.get('dataChangeCreatedTime')}  "
+            f"by={b.get('dataChangeCreatedBy')}  name={b.get('name')}  "
+            f"abandoned={b.get('isAbandoned')}  items={len(items)}"
+        )
+        print(f"       comment: {b.get('comment')}")
+        print(f"       keys   : {[i.get('key') for i in items]}")
+
+    # 4. 最近一条相对前一条的 diff
+    if len(rels) >= 1:
+        from mcp_apollo_explorer.diff import diff_items
+
+        print(f"\n[4] diff  最新一条 vs 前一条")
+        cur = rels[0]
+        prev = rels[1] if len(rels) > 1 else None
+        changes = diff_items(
+            (prev.get("items") if prev else None),
+            cur.get("items") or [],
+        )
+        print(json.dumps(mask_changes(changes, args.full), ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

mcp_apollo_explorer-0.1.0/src/mcp_apollo_explorer/__init__.py

@@ -0,0 +1,3 @@
+"""mcp-apollo-explorer: Apollo config center explorer MCP server."""
+
+__version__ = "0.1.0"