sogou-weixin-mcp-server

mcp
Security Audit
Warn
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool acts as an MCP server that allows AI agents and LLMs to search for WeChat public account articles via the Sogou WeChat platform. It returns structured data such as titles, snippets, URLs, and dates based on user-provided keywords.

Security Assessment
Overall Risk: Low. The codebase was scanned and found to be safe, with no dangerous execution patterns or hardcoded secrets. It functions exactly as described by making standard network requests to the Sogou search engine to retrieve data. It does not request dangerous system permissions. However, since it is designed to run via a single command directly from the GitHub repository (`uvx --from git+...`), users should be aware that any future malicious changes to the main branch would execute automatically without local review.

Quality Assessment
The project is actively maintained, with its most recent update occurring today. However, it currently suffers from low community visibility and trust, having accumulated only 5 GitHub stars. A significant concern is the complete lack of an open-source license. Without a license, the code is technically proprietary, meaning you do not have formal legal permission to use, modify, or distribute it, which may be a strict dealbreaker for commercial or enterprise environments.

Verdict
Use with caution — the code itself is safe and functions as a simple search wrapper, but the complete lack of a software license poses potential legal risks for downstream users.
SUMMARY

This project provides a tool for searching articles through Sogou WeChat and encapsulates it as an MCP (Model Context Protocol) server.

README.md

Sogou WeChat Search MCP Server

简体中文 README

This project provides a tool for searching articles through Sogou WeChat and encapsulates it as an MCP (Model Context Protocol) server.

Key Highlights:

  • WeChat Article Search: Enables searching for WeChat official account articles through the Sogou WeChat platform.
  • Flexible Query: Supports searching by keywords and specifying the number of articles to return.
  • Structured Output: Returns structured article information including title, snippet, URL, source, and date, facilitating further processing.
  • MCP Server Integration: Encapsulates the WeChat article search functionality as an MCP tool, allowing other AI agents or systems to call it via the MCP protocol.

How to Use

Quick Start (Recommended)

You can run the server directly with uvx — no clone, no install, no setup:

uvx --from git+https://github.com/ptbsare/sogou-weixin-mcp-server.git sogou-weixin-mcp-server

This downloads and runs the latest version in one shot.

1. Environment Setup (Local Development)

Ensure your system has Python 3.10 or higher installed.

It is recommended to use uv for dependency management:

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone the repository
git clone https://github.com/ptbsare/sogou-weixin-mcp-server.git
cd sogou-weixin-mcp-server

# Install dependencies using uv
uv sync

2. Usage as an MCP Server

You can run this project as an MCP server, allowing other AI agents or systems to call the search_wechat_articles tool via the MCP protocol.

# Run via uv (local directory)
uv run sogou-weixin-mcp-server

# Or run the script directly
uv run server.py

Once the server starts, it will listen for MCP client requests over stdio.

3. Claude MCP Server Configuration Example

Below is an example mcp_server.json configuration file to connect this MCP server to Claude:

Option A: Using uvx (no local clone needed)

{
  "mcp_servers": [
    {
      "name": "sogou-wechat-search",
      "type": "stdio",
      "command": ["uvx", "--from", "git+https://github.com/ptbsare/sogou-weixin-mcp-server.git", "sogou-weixin-mcp-server"]
    }
  ]
}

Option B: Using local directory

{
  "mcp_servers": [
    {
      "name": "sogou-wechat-search",
      "type": "stdio",
      "command": ["uv", "--directory", "/path/to/sogou-weixin-mcp-server/", "run", "server.py"]
    }
  ]
}

4. Available Tools

search_wechat_articles

Search for WeChat articles via Sogou WeChat.

Parameter Type Required Default Description
query string Yes Search keyword
top_num integer No 18 Maximum number of articles to return

Returns: A list of dictionaries, each containing:

  • title — Article title
  • snippet — Article summary/snippet
  • url — Article URL
  • source — WeChat official account name
  • date — Publication date

Reviews (0)

No results found