mcp-notify 0.1.0__tar.gz

mcp_notify-0.1.0/.github/workflows/docker.yaml

@@ -0,0 +1,125 @@
+name: Build Docker Image
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+  push:
+    branches: [main]
+    paths-ignore:
+      - .github/**
+
+env:
+  GITHUB_CR_REPO: ghcr.io/${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - linux/amd64
+          - linux/arm64
+    steps:
+      - name: Prepare
+        run: |
+          platform=${{ matrix.platform }}
+          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ env.GITHUB_CR_REPO }}
+
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build and push by digest
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          platforms: ${{ matrix.platform }}
+          labels: ${{ steps.meta.outputs.labels }}
+          tags: |
+            ${{ env.GITHUB_CR_REPO }}
+          outputs: type=image,push-by-digest=true,name-canonical=true,push=true
+
+      - name: Export digest
+        run: |
+          mkdir -p ${{ runner.temp }}/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "${{ runner.temp }}/digests/${digest#sha256:}"
+
+      - name: Upload digest
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-${{ env.PLATFORM_PAIR }}
+          path: ${{ runner.temp }}/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  merge:
+    runs-on: ubuntu-latest
+    needs:
+      - build
+    steps:
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: ${{ runner.temp }}/digests
+          pattern: digests-*
+          merge-multiple: true
+
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ${{ env.GITHUB_CR_REPO }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+
+      - name: Docker tags
+        run: |
+          tags=$(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON")
+          if [ -z "$tags" ]; then
+            echo "DOCKER_METADATA_OUTPUT_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
+            tags="-t ${{ env.GITHUB_CR_REPO }}:${{ github.ref_name }}"
+          fi
+          echo "DOCKER_METADATA_TAGS=$tags" >> $GITHUB_ENV
+
+      - name: Create manifest list and push
+        working-directory: ${{ runner.temp }}/digests
+        run: |
+          docker buildx imagetools create ${{ env.DOCKER_METADATA_TAGS }} \
+            $(printf '${{ env.GITHUB_CR_REPO }}@sha256:%s ' *)
+
+      - name: Inspect image
+        run: |
+          docker buildx imagetools inspect ${{ env.GITHUB_CR_REPO }}:${{ env.DOCKER_METADATA_OUTPUT_VERSION }}

mcp_notify-0.1.0/.github/workflows/pypi.yaml

@@ -0,0 +1,62 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+  push:
+    branches: [main]
+    paths-ignore:
+      - .github/**
+
+env:
+  PYPI_PKG_NAME: mcp-notify
+
+jobs:
+  build:
+    name: Build distribution 📦
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+
+    - name: Install pypa/build
+      run: python3 -m pip install build --user
+
+    - name: Build a binary wheel and a source tarball
+      run: python3 -m build
+
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+  publish-to-pypi:
+    name: Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/tags/')
+    needs:
+    - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/${{ env.PYPI_PKG_NAME }}
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

mcp_notify-0.1.0/.github/workflows/release.yaml

@@ -0,0 +1,33 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for OIDC authentication with MCP Registry
+      contents: read
+    steps:
+      - name: Wait for release
+        if: "github.event_name == 'release'"
+        run: sleep 120
+
+      - uses: actions/checkout@v4
+
+      - name: Install MCP Publisher
+        #if: "!github.event.release.prerelease"
+        run: |
+          curl -o mcp-publisher.tgz -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz"
+          tar zxvf mcp-publisher.tgz mcp-publisher
+
+      - name: Login to MCP Registry
+        #if: "!github.event.release.prerelease"
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        #if: "!github.event.release.prerelease"
+        run: ./mcp-publisher publish

mcp_notify-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.idea
+.cache
+.DS_Store

mcp_notify-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

mcp_notify-0.1.0/Dockerfile

@@ -0,0 +1,19 @@
+FROM ghcr.io/astral-sh/uv:python3.13-alpine
+
+LABEL io.modelcontextprotocol.server.name="io.github.aahl/mcp-notify"
+
+ENV PYTHONUNBUFFERED=1 \
+    UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    PATH="/app/.venv/bin:$PATH" \
+    TRANSPORT=http \
+    PORT=80
+
+WORKDIR /app
+COPY . .
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev
+
+CMD ["uv", "run", "-m", "mcp_notify"]
+HEALTHCHECK --interval=1m --start-period=30s CMD nc -zn 0.0.0.0 $PORT || exit 1

mcp_notify-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 aahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_notify-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: mcp-notify
+Version: 0.1.0
+Summary: MCP Server for notify
+Project-URL: Repository, https://github.com/aahl/mcp-notify
+License: MIT
+License-File: LICENSE
+Keywords: llm,mcp,notify,telegram,weixin,wework
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.0.0
+Description-Content-Type: text/markdown
+
+# 💬 Notify MCP Server
+
+<!-- mcp-name: io.github.aahl/mcp-notify -->
+
+提供消息推送的 MCP (Model Context Protocol) 服务器
+
+
+## 安装
+
+### 方式1: uvx
+```yaml
+{
+  "mcpServers": {
+    "mcp-notify": {
+      "command": "uvx",
+      "args": ["mcp-notify"],
+      "env": {
+        "WEWORK_BOT_KEY": "your-wework-bot-key" # 企业微信群机器人key
+      }
+    }
+  }
+}
+```
+
+### 方式2: Docker
+```bash
+mkdir /opt/mcp-notify
+cd /opt/mcp-notify
+wget https://raw.githubusercontent.com/aahl/mcp-notify/refs/heads/main/docker-compose.yml
+docker-compose up -d
+```
+```yaml
+{
+  "mcpServers": {
+    "mcp-notify": {
+      "url": "http://0.0.0.0:8809/mcp" # Streamable HTTP
+    }
+  }
+}
+```

mcp_notify-0.1.0/README.md

@@ -0,0 +1,40 @@
+# 💬 Notify MCP Server
+
+<!-- mcp-name: io.github.aahl/mcp-notify -->
+
+提供消息推送的 MCP (Model Context Protocol) 服务器
+
+
+## 安装
+
+### 方式1: uvx
+```yaml
+{
+  "mcpServers": {
+    "mcp-notify": {
+      "command": "uvx",
+      "args": ["mcp-notify"],
+      "env": {
+        "WEWORK_BOT_KEY": "your-wework-bot-key" # 企业微信群机器人key
+      }
+    }
+  }
+}
+```
+
+### 方式2: Docker
+```bash
+mkdir /opt/mcp-notify
+cd /opt/mcp-notify
+wget https://raw.githubusercontent.com/aahl/mcp-notify/refs/heads/main/docker-compose.yml
+docker-compose up -d
+```
+```yaml
+{
+  "mcpServers": {
+    "mcp-notify": {
+      "url": "http://0.0.0.0:8809/mcp" # Streamable HTTP
+    }
+  }
+}
+```

mcp_notify-0.1.0/docker-compose.yml

@@ -0,0 +1,10 @@
+services:
+  mcp-notify:
+    container_name: mcp_notify
+    image: ghcr.nju.edu.cn/aahl/mcp-notify
+    ports:
+      - 8809:80
+    environment:
+      TZ: Asia/Shanghai
+      UV_INDEX_URL: https://mirrors.ustc.edu.cn/pypi/simple
+    restart: always

mcp_notify-0.1.0/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "al-one"
+  ]
+}

mcp_notify-0.1.0/mcp_notify/__init__.py

@@ -0,0 +1,112 @@
+import os
+import logging
+import argparse
+import requests
+import hashlib
+import base64
+from fastmcp import FastMCP
+from pydantic import Field
+from starlette.middleware.cors import CORSMiddleware
+
+
+_LOGGER = logging.getLogger(__name__)
+
+mcp = FastMCP(name="mcp-notify")
+
+WEWORK_BOT_KEY = os.getenv("WEWORK_BOT_KEY", "")
+WEWORK_BASE_URL = os.getenv("WEWORK_BASE_URL") or "https://qyapi.weixin.qq.com"
+
+
+@mcp.tool(
+    title="企业微信群机器人-发送文本消息",
+    description="通过企业微信群机器人发送文本或Markdown消息",
+)
+def wework_send_text(
+    text: str = Field(description="消息内容，长度限制: (text: 2048个字节, markdown_v2: 4096个字节)"),
+    msgtype: str = Field("text", description="内容类型，仅支持: text/markdown_v2"),
+    bot_key: str = Field(WEWORK_BOT_KEY, description="机器人key，uuid格式"),
+):
+    if msgtype == "markdown":
+        msgtype = "markdown_v2"
+    res = requests.post(
+        f"{WEWORK_BASE_URL}/cgi-bin/webhook/send?key={bot_key}",
+        json={"msgtype": msgtype, msgtype: {"content": text}},
+    )
+    return res.json()
+
+
+@mcp.tool(
+    title="企业微信群机器人-发送图片消息",
+    description="通过企业微信群机器人发送图片消息",
+)
+def wework_send_image(
+    url: str = Field(description="图片url"),
+    bot_key: str = Field(WEWORK_BOT_KEY, description="机器人key，uuid格式"),
+):
+    res = requests.get(url, timeout=60)
+    res.raise_for_status()
+    b64str = base64.b64encode(res.content).decode()
+    md5str = hashlib.md5(res.content).hexdigest()
+    res = requests.post(
+        f"{WEWORK_BASE_URL}/cgi-bin/webhook/send?key={bot_key}",
+        json={"msgtype": "image", "image": {"base64": b64str, "md5": md5str}},
+    )
+    return res.json()
+
+
+@mcp.tool(
+    title="企业微信群机器人-发送图文消息",
+    description="通过企业微信群机器人发送图文链接消息",
+)
+def wework_send_news(
+    title: str = Field(description="标题，不超过128个字节"),
+    description: str = Field("", description="描述，不超过512个字节"),
+    url: str = Field(description="跳转链接，必填"),
+    picurl: str = Field("", description="图片url"),
+    bot_key: str = Field(WEWORK_BOT_KEY, description="机器人key，uuid格式"),
+):
+    res = requests.post(
+        f"{WEWORK_BASE_URL}/cgi-bin/webhook/send?key={bot_key}",
+        json={
+            "msgtype": "news",
+            "news": {
+                "articles": [
+                    {
+                        "title": title,
+                        "description": description,
+                        "url": url,
+                        "picurl": picurl,
+                    },
+                ],
+            },
+        },
+    )
+    return res.json()
+
+
+def main():
+    mode = os.getenv("TRANSPORT")
+    port = int(os.getenv("PORT", 0)) or 80
+    parser = argparse.ArgumentParser(description="Notify MCP Server")
+    parser.add_argument("--http", action="store_true", help="Use streamable HTTP mode instead of stdio")
+    parser.add_argument("--host", default="0.0.0.0", help="Host to bind to (default: 0.0.0.0)")
+    parser.add_argument("--port", type=int, default=port, help=f"Port to listen on (default: {port})")
+
+    args = parser.parse_args()
+    if args.http or mode == "http":
+        app = mcp.streamable_http_app()
+        app.add_middleware(
+            CORSMiddleware,
+            allow_origins=["*"],
+            allow_credentials=True,
+            allow_methods=["GET", "POST", "OPTIONS"],
+            allow_headers=["*"],
+            expose_headers=["mcp-session-id", "mcp-protocol-version"],
+            max_age=86400,
+        )
+        mcp.run(transport="http", host=args.host, port=args.port)
+    else:
+        mcp.run()
+
+if __name__ == "__main__":
+    main()

mcp_notify-0.1.0/mcp_notify/__main__.py

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

mcp_notify-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "mcp-notify"
+version = "0.1.0"
+description = "MCP Server for notify"
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["notify", "telegram", "weixin", "wework", "mcp", "llm"]
+license = { text = "MIT" }
+dependencies = [
+    "fastmcp>=2.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/aahl/mcp-notify"
+
+[project.scripts]
+mcp-notify = "mcp_notify:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

mcp_notify-0.1.0/server.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "io.github.aahl/mcp-notify",
+  "title": "Notify MCP Server",
+  "description": "MCP Server for notify",
+  "version": "0.1.0",
+  "repository": {
+    "url": "https://github.com/aahl/mcp-notify",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "mcp-notify",
+      "version": "0.1.0",
+      "transport": {"type": "stdio"}
+    },
+    {
+      "registryType": "oci",
+      "identifier": "ghcr.io/aahl/mcp-notify:latest",
+      "transport": {"type": "stdio"}
+    }
+  ]
+}

mcp_notify-0.1.0/smithery.yaml

@@ -0,0 +1,6 @@
+runtime: container
+startCommand:
+  type: http
+build:
+  dockerfile: Dockerfile
+  dockerBuildPath: "."