wechatmp-mcp 0.0.1__tar.gz

wechatmp_mcp-0.0.1/.gitignore

@@ -0,0 +1,148 @@
+# Python
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask
+instance/
+.webassets-cache
+
+# Scrapy
+.scrapy
+
+# Sphinx
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# Virtual environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Package managers
+.pdm-python
+.pdm-build/
+.pixi
+__pypackages__/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+cython_debug/
+.ruff_cache/
+
+# Spyder / Rope
+.spyderproject
+.spyproject
+.ropeproject
+
+# mkdocs
+/site
+
+# Abstra
+.abstra/
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# PyPI
+.pypirc
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Cursor
+.cursorignore
+.cursorindexingignore
+
+# Project-specific
+browser_data/
+screenshots/
+logs/
+
+# OS
+.DS_Store
+Thumbs.db

wechatmp_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: wechatmp-mcp
+Version: 0.0.1
+Summary: MCP service for WeChat Official Account (微信公众号) content retrieval
+Author: wechatmp-mcp
+License-Expression: MIT
+Keywords: mcp,playwright,wechat,weixin,公众号,微信
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: html2text>=2020.1.16
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: starlette>=0.37.0
+Requires-Dist: uvicorn>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# wechatmp-mcp
+
+`wechatmp-mcp` 是一个面向 MCP 客户端使用者的微信公众号 MCP Server。它通过微信公众号后台接口，提供扫码登录、搜索公众号、获取文章列表、读取文章正文、批量抓取多账号近期文章等能力。
+
+你可以把它接入支持 MCP 的客户端，例如 Claude Code、Cline、MCP Inspector，或任何兼容 `stdio` 的 MCP 工具。
+
+## 它能做什么
+
+- 获取微信公众号后台登录二维码，扫码完成登录，自动保存登录态到本地
+- 登录态保存在 `~/.wechat-mcp/`，重启后无需重新登录
+- 按关键词搜索公众号，获取 fakeid、昵称、简介等信息
+- 获取指定公众号的文章列表（标题、链接、摘要、封面、发布时间）
+- 读取指定文章 URL 的正文，以 Markdown 格式返回
+- 批量获取多个公众号的近期文章摘要
+
+当前项目实际注册了 **7 个 MCP tools**。
+
+## 环境要求
+
+- Python 3.10 或更高版本
+- 能访问微信公众号网页（mp.weixin.qq.com）
+
+## 通过 uvx 使用（推荐）
+
+无需手动安装，uvx 会自动处理。
+
+### Claude Code 配置
+
+```bash
+claude mcp add wechat -- uvx wechatmp-mcp
+```
+
+### 快速调试
+
+```sh
+npx @modelcontextprotocol/inspector uvx wechatmp-mcp
+```
+
+> ⚠️ **注意：** 请务必先使用 `get_login_qrcode` + `check_login_status` 完成登录后再使用其他工具！
+
+## MCP 客户端配置
+
+### Claude Code
+
+```bash
+claude mcp add wechat -- uvx wechatmp-mcp
+```
+
+### Cline / JSON 配置
+
+```json
+{
+  "mcpServers": {
+    "wechatmp-mcp": {
+      "command": "uvx",
+      "args": ["wechatmp-mcp"]
+    }
+  }
+}
+```
+
+## Tools 一览
+
+### 账号登录
+
+- `get_login_qrcode`：获取微信公众号后台登录二维码，图片保存到本地，返回文件路径
+- `check_login_status`：检查登录状态；若用户已扫码则完成登录并保存 auth，否则验证已保存 auth 是否有效
+- `logout`：清除本地保存的 auth（token + cookies），退出登录
+
+### 公众号搜索
+
+- `search_account`：按关键词搜索公众号，返回 fakeid、nickname、alias、intro、avatar
+
+### 文章获取
+
+- `get_account_articles`：获取指定公众号的文章列表（按发布时间倒序），支持按 fakeid 或公众号名称查询，支持翻页
+- `get_article_content`：传入文章 URL，返回清洗后的 Markdown 正文
+- `batch_get_articles`：传入公众号名称列表，批量获取近期文章摘要
+
+## 发布新版本到 PyPI
+
+修改代码后，更新 `src/wechat_mcp/__init__.py` 中的版本号，然后：
+
+```sh
+# 安装构建工具（首次需要）
+pip install hatch twine -i https://pypi.org/simple/
+
+# 构建
+hatch build
+
+# 上传到 PyPI
+# Username: __token__
+# Password: 在 https://pypi.org/manage/account/ 的 API tokens 中创建
+python -m twine upload dist/*
+
+# 验证上传成功
+uvx wechatmp-mcp==<新版本号> --help
+```
+
+> 注意：上传后 PyPI 同步约需 1-2 分钟，验证前稍等片刻。
+
+## 使用建议
+
+- 使用其他工具前，请先通过 `get_login_qrcode` 获取二维码并扫码，再调用 `check_login_status` 完成登录
+- 登录态保存在 `~/.wechat-mcp/`，重启服务后无需重新登录
+- `get_account_articles` 需要先通过 `search_account` 获取公众号的 `fakeid`

wechatmp_mcp-0.0.1/README.md

@@ -0,0 +1,106 @@
+# wechatmp-mcp
+
+`wechatmp-mcp` 是一个面向 MCP 客户端使用者的微信公众号 MCP Server。它通过微信公众号后台接口，提供扫码登录、搜索公众号、获取文章列表、读取文章正文、批量抓取多账号近期文章等能力。
+
+你可以把它接入支持 MCP 的客户端，例如 Claude Code、Cline、MCP Inspector，或任何兼容 `stdio` 的 MCP 工具。
+
+## 它能做什么
+
+- 获取微信公众号后台登录二维码，扫码完成登录，自动保存登录态到本地
+- 登录态保存在 `~/.wechat-mcp/`，重启后无需重新登录
+- 按关键词搜索公众号，获取 fakeid、昵称、简介等信息
+- 获取指定公众号的文章列表（标题、链接、摘要、封面、发布时间）
+- 读取指定文章 URL 的正文，以 Markdown 格式返回
+- 批量获取多个公众号的近期文章摘要
+
+当前项目实际注册了 **7 个 MCP tools**。
+
+## 环境要求
+
+- Python 3.10 或更高版本
+- 能访问微信公众号网页（mp.weixin.qq.com）
+
+## 通过 uvx 使用（推荐）
+
+无需手动安装，uvx 会自动处理。
+
+### Claude Code 配置
+
+```bash
+claude mcp add wechat -- uvx wechatmp-mcp
+```
+
+### 快速调试
+
+```sh
+npx @modelcontextprotocol/inspector uvx wechatmp-mcp
+```
+
+> ⚠️ **注意：** 请务必先使用 `get_login_qrcode` + `check_login_status` 完成登录后再使用其他工具！
+
+## MCP 客户端配置
+
+### Claude Code
+
+```bash
+claude mcp add wechat -- uvx wechatmp-mcp
+```
+
+### Cline / JSON 配置
+
+```json
+{
+  "mcpServers": {
+    "wechatmp-mcp": {
+      "command": "uvx",
+      "args": ["wechatmp-mcp"]
+    }
+  }
+}
+```
+
+## Tools 一览
+
+### 账号登录
+
+- `get_login_qrcode`：获取微信公众号后台登录二维码，图片保存到本地，返回文件路径
+- `check_login_status`：检查登录状态；若用户已扫码则完成登录并保存 auth，否则验证已保存 auth 是否有效
+- `logout`：清除本地保存的 auth（token + cookies），退出登录
+
+### 公众号搜索
+
+- `search_account`：按关键词搜索公众号，返回 fakeid、nickname、alias、intro、avatar
+
+### 文章获取
+
+- `get_account_articles`：获取指定公众号的文章列表（按发布时间倒序），支持按 fakeid 或公众号名称查询，支持翻页
+- `get_article_content`：传入文章 URL，返回清洗后的 Markdown 正文
+- `batch_get_articles`：传入公众号名称列表，批量获取近期文章摘要
+
+## 发布新版本到 PyPI
+
+修改代码后，更新 `src/wechat_mcp/__init__.py` 中的版本号，然后：
+
+```sh
+# 安装构建工具（首次需要）
+pip install hatch twine -i https://pypi.org/simple/
+
+# 构建
+hatch build
+
+# 上传到 PyPI
+# Username: __token__
+# Password: 在 https://pypi.org/manage/account/ 的 API tokens 中创建
+python -m twine upload dist/*
+
+# 验证上传成功
+uvx wechatmp-mcp==<新版本号> --help
+```
+
+> 注意：上传后 PyPI 同步约需 1-2 分钟，验证前稍等片刻。
+
+## 使用建议
+
+- 使用其他工具前，请先通过 `get_login_qrcode` 获取二维码并扫码，再调用 `check_login_status` 完成登录
+- 登录态保存在 `~/.wechat-mcp/`，重启服务后无需重新登录
+- `get_account_articles` 需要先通过 `search_account` 获取公众号的 `fakeid`

wechatmp_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "wechatmp-mcp"
+dynamic = ["version"]
+description = "MCP service for WeChat Official Account (微信公众号) content retrieval"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "wechatmp-mcp" }
+]
+keywords = ["mcp", "wechat", "weixin", "微信", "公众号", "playwright"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "starlette>=0.37.0",
+    "uvicorn>=0.24.0",
+    "playwright>=1.40.0",
+    "httpx>=0.25.0",
+    "beautifulsoup4>=4.12.0",
+    "html2text>=2020.1.16",
+    "python-dotenv>=1.0.0",
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.scripts]
+wechatmp-mcp = "wechat_mcp.server:main"
+
+[tool.hatch.version]
+path = "src/wechat_mcp/__init__.py"
+validate-bump = false
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/wechat_mcp"]

wechatmp_mcp-0.0.1/src/wechat_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""WeChat MCP - MCP service for WeChat Official Account (微信公众号) content retrieval."""
+
+__version__ = "0.0.1"

wechatmp_mcp-0.0.1/src/wechat_mcp/__main__.py

@@ -0,0 +1,3 @@
+from wechat_mcp.server import main
+
+main()

wechatmp_mcp-0.0.1/src/wechat_mcp/config.py

@@ -0,0 +1,53 @@
+"""Configuration management using pydantic-settings."""
+
+from pathlib import Path
+from typing import Literal, Optional
+
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    # Browser (used only for login QR code)
+    headless: bool = Field(default=False, description="Run browser in headless mode (False to show QR code)")
+    page_timeout: int = Field(default=30000, description="Page timeout in milliseconds")
+
+    # Storage
+    data_dir: Path = Field(
+        default=Path.home() / ".wechat-mcp",
+        description="Directory for auth store and screenshots",
+    )
+
+    # Logging
+    log_level: str = Field(default="INFO", description="Logging level")
+
+    # MCP transport
+    mcp_transport: Literal["stdio", "streamable_http"] = Field(default="stdio")
+    mcp_tool_timeout_seconds: float = Field(default=60.0, gt=0)
+    mcp_http_host: str = Field(default="127.0.0.1")
+    mcp_http_port: int = Field(default=18001, ge=1, le=65535)
+    mcp_streamable_http_path: str = Field(default="/mcp")
+
+    @property
+    def screenshots_dir(self) -> Path:
+        return self.data_dir / "screenshots"
+
+    @property
+    def auth_file(self) -> Path:
+        return self.data_dir / "auth.json"
+
+
+_settings: Optional[Settings] = None
+
+
+def get_settings() -> Settings:
+    global _settings
+    if _settings is None:
+        _settings = Settings()
+    return _settings

wechatmp_mcp-0.0.1/src/wechat_mcp/constants.py

@@ -0,0 +1,27 @@
+"""Constants for WeChat MCP."""
+
+BASE_URL = "https://mp.weixin.qq.com"
+LOGIN_URL = f"{BASE_URL}/"
+
+USER_AGENTS = [
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/120.0",
+]
+
+# API paths
+SEARCHBIZ_URL = f"{BASE_URL}/cgi-bin/searchbiz"
+APPMSG_URL = f"{BASE_URL}/cgi-bin/appmsg"
+BIZLOGIN_START_URL = f"{BASE_URL}/cgi-bin/bizlogin?action=startlogin"
+BIZLOGIN_URL = f"{BASE_URL}/cgi-bin/bizlogin?action=login"
+SCANLOGIN_URL = f"{BASE_URL}/cgi-bin/scanloginqrcode"
+
+# QR code status codes
+QR_STATUS_WAITING = 0
+QR_STATUS_SCANNED = 2
+QR_STATUS_CONFIRMED = 4
+QR_STATUS_SUCCESS_1 = 1
+QR_STATUS_SUCCESS_3 = 3
+QR_STATUS_SELECTING = 6
+QR_STATUS_EXPIRED = 5
+QR_STATUS_CANCELLED = -1

wechatmp_mcp-0.0.1/src/wechat_mcp/errors.py

@@ -0,0 +1,41 @@
+"""Error definitions for WeChat MCP service."""
+
+from enum import Enum
+from typing import Optional
+
+
+class ErrorCode(str, Enum):
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+    BROWSER_START_FAILED = "BROWSER_START_FAILED"
+    NOT_LOGGED_IN = "NOT_LOGGED_IN"
+    LOGIN_FAILED = "LOGIN_FAILED"
+    LOGIN_TIMEOUT = "LOGIN_TIMEOUT"
+    QRCODE_NOT_FOUND = "QRCODE_NOT_FOUND"
+    API_ERROR = "API_ERROR"
+    RATE_LIMITED = "RATE_LIMITED"
+    INVALID_PARAMETER = "INVALID_PARAMETER"
+    ARTICLE_FETCH_FAILED = "ARTICLE_FETCH_FAILED"
+
+
+class WechatMCPError(Exception):
+    def __init__(
+        self,
+        message: str,
+        code: ErrorCode = ErrorCode.UNKNOWN_ERROR,
+        details: Optional[dict] = None,
+    ):
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.details = details or {}
+
+
+class LoginError(WechatMCPError):
+    def __init__(self, message: str, code: ErrorCode = ErrorCode.LOGIN_FAILED, details: Optional[dict] = None):
+        super().__init__(message, code, details)
+
+
+class ApiError(WechatMCPError):
+    def __init__(self, message: str, code: ErrorCode = ErrorCode.API_ERROR, details: Optional[dict] = None):
+        super().__init__(message, code, details)

wechatmp_mcp-0.0.1/src/wechat_mcp/infrastructure/__init__.py

@@ -0,0 +1 @@
+# infrastructure package

wechatmp_mcp-0.0.1/src/wechat_mcp/infrastructure/api/__init__.py

@@ -0,0 +1,3 @@
+from .wechat_client import WechatClient, get_wechat_client
+
+__all__ = ["WechatClient", "get_wechat_client"]