gamefa-mcp 0.1.0__tar.gz

gamefa_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run pytest -q

gamefa_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish
+
+# Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
+# pyproject.toml and server.json.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # PyPI trusted publishing
+      contents: write  # GitHub Release
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+      - name: Check versions match the tag
+        run: |
+          TAG=${GITHUB_REF_NAME#v}
+          grep -q "^version = \"$TAG\"" pyproject.toml
+          test "$(jq -r .version server.json)" = "$TAG"
+          test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
+      - run: uv sync --locked && uv run pytest -q
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+  mcp-registry:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # MCP Registry login via GitHub OIDC
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+      - name: Wait for PyPI to serve the new version
+        run: |
+          for i in $(seq 1 30); do
+            curl -sf "https://pypi.org/pypi/gamefa-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
+            sleep 10
+          done
+          exit 1
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+      - run: ./mcp-publisher login github-oidc
+      - run: ./mcp-publisher publish

gamefa_mcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+.pytest_cache/
+.ruff_cache/

gamefa_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sepehr Radmard
+
+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.

gamefa_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.5
+Name: gamefa-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for Gamefa (gamefa.com), the Persian game and film site: news, reviews with scores, game and film profiles, upcoming releases.
+Project-URL: Homepage, https://github.com/sepehr071/gamefa-mcp
+Project-URL: Issues, https://github.com/sepehr071/gamefa-mcp/issues
+Project-URL: Website, https://mcpfarsi.ir/
+Author-email: Sepehr Radmard <sepehrr80@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cinema,claude,farsi,game-news,game-reviews,gamefa,gamefa-com,iran,mcp,model-context-protocol,persian,release-calendar,video-games
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.16.3
+Requires-Dist: httpx-curl-cffi>=0.1.5
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=2.2
+Description-Content-Type: text/markdown
+
+<!-- mcp-name: io.github.sepehr071/gamefa-mcp -->
+
+# gamefa-mcp: Gamefa (گیمفا) game and film news, reviews and release calendar MCP server for AI agents
+
+**gamefa-mcp is an unofficial, read-only MCP server that gives AI agents Gamefa (گیمفا, gamefa.com), the large Persian site for video games, film and tech.**<br>
+Its 13 tools search and read articles, list the editors' scored reviews, browse game and film profiles with Gamefa, user and IMDb scores,<br>
+show the upcoming release calendar and rank the most read articles. No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/gamefa-mcp?color=2563eb)](https://pypi.org/project/gamefa-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/gamefa-mcp/blob/main/LICENSE)
+
+[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [فارسی](#فارسی)
+
+---
+
+## For AI agents
+
+- **What:** unofficial MCP server (model context protocol) for gamefa.com: news and review search, full article text, review scores with pros and cons, game profiles (Gamefa score, user score, Metacritic, platforms, genres, publisher, release date), film and series profiles (IMDb, cast, director), upcoming game releases, most read articles.
+- **Install:** `uvx gamefa-mcp` or `claude mcp add gamefa -- uvx gamefa-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
+- **Auth:** none. Optional `GAMEFA_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
+- **Access:** read-only. It cannot log in, comment or rate, so no confirmation is needed before calling any tool.
+- **Tools:** 13, all prefixed `gf_`. Typical sequences: `gf_games(query)` -> `gf_game(slug)` -> `gf_article(review id)`; `gf_upcoming_games`; `gf_search_articles` -> `gf_article`.
+- **Use when:** the user asks what Gamefa says about a game, its review score, the latest game or film news, what releases next, top rated games of a platform or genre, or what is trending.
+- **Do not use when:** the user needs scores from other sites (Metacritic, OpenCritic) beyond what Gamefa lists, or prices and stores.
+- **Output:** compact JSON. Article text is Persian; game and film titles are English. Scores are out of 10; release dates come as Jalali and ISO.
+
+## Quick start
+
+```bash
+claude mcp add gamefa -- uvx gamefa-mcp
+```
+
+Or in any MCP client config: `{"command": "uvx", "args": ["gamefa-mcp"]}`.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `gf_search_articles` | Search news, reviews and features by keyword, optionally in one section |
+| `gf_latest_articles` | Newest articles, optionally for news, reviews, trailers, pc, playstation, cinema... |
+| `gf_article` | Full article text by id or slug; reviews include score, label, verdict, pros, cons |
+| `gf_reviews` | Latest game reviews with the editors' score out of 10 |
+| `gf_popular` | Most viewed articles of the week, month, season or year |
+| `gf_games` | Game profiles with Gamefa and user scores; sort, search, filter by platform, genre, developer, publisher, release year |
+| `gf_upcoming_games` | Release calendar: unreleased games, soonest first; by month, platform or genre |
+| `gf_game` | One game profile: scores, Metacritic, release, platforms, genres, review link |
+| `gf_films` | Film and series profiles with IMDb and user scores; filter by movie/series, genre, person, studio, country, language, year |
+| `gf_film` | One film or series: cast, director, countries, runtime, scores |
+| `gf_terms` | Look up the slug of a platform, genre, developer, publisher, film person or studio, or an article tag |
+| `gf_comments` | Reader comments (with likes) under an article or a game/film profile |
+| `gf_related` | Articles Gamefa links to a game/film, or similar games/films |
+
+## FAQ
+
+**Does it need an account?** No. **Is it official?** No, it reads the public pages and REST API of gamefa.com.
+**Which network?** Both Iranian and foreign connections reach the site; set `GAMEFA_MCP_PROXY` if yours is blocked.
+
+## فارسی
+
+gamefa-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای سایت گیمفا (gamefa.com) است: جست‌وجوی اخبار و مقالات، متن کامل نقدها همراه با امتیاز، مشخصات و امتیاز بازی‌ها و فیلم‌ها، بازی‌های در راه و پربازدیدترین مطالب. نیازی به کلید API یا حساب کاربری نیست.
+
+---
+
+Made by Sepehr Radmard (سپهر رادمرد): [github.com/sepehr071](https://github.com/sepehr071) · [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.

gamefa_mcp-0.1.0/README.md

@@ -0,0 +1,64 @@
+<!-- mcp-name: io.github.sepehr071/gamefa-mcp -->
+
+# gamefa-mcp: Gamefa (گیمفا) game and film news, reviews and release calendar MCP server for AI agents
+
+**gamefa-mcp is an unofficial, read-only MCP server that gives AI agents Gamefa (گیمفا, gamefa.com), the large Persian site for video games, film and tech.**<br>
+Its 13 tools search and read articles, list the editors' scored reviews, browse game and film profiles with Gamefa, user and IMDb scores,<br>
+show the upcoming release calendar and rank the most read articles. No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/gamefa-mcp?color=2563eb)](https://pypi.org/project/gamefa-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/gamefa-mcp/blob/main/LICENSE)
+
+[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [فارسی](#فارسی)
+
+---
+
+## For AI agents
+
+- **What:** unofficial MCP server (model context protocol) for gamefa.com: news and review search, full article text, review scores with pros and cons, game profiles (Gamefa score, user score, Metacritic, platforms, genres, publisher, release date), film and series profiles (IMDb, cast, director), upcoming game releases, most read articles.
+- **Install:** `uvx gamefa-mcp` or `claude mcp add gamefa -- uvx gamefa-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
+- **Auth:** none. Optional `GAMEFA_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
+- **Access:** read-only. It cannot log in, comment or rate, so no confirmation is needed before calling any tool.
+- **Tools:** 13, all prefixed `gf_`. Typical sequences: `gf_games(query)` -> `gf_game(slug)` -> `gf_article(review id)`; `gf_upcoming_games`; `gf_search_articles` -> `gf_article`.
+- **Use when:** the user asks what Gamefa says about a game, its review score, the latest game or film news, what releases next, top rated games of a platform or genre, or what is trending.
+- **Do not use when:** the user needs scores from other sites (Metacritic, OpenCritic) beyond what Gamefa lists, or prices and stores.
+- **Output:** compact JSON. Article text is Persian; game and film titles are English. Scores are out of 10; release dates come as Jalali and ISO.
+
+## Quick start
+
+```bash
+claude mcp add gamefa -- uvx gamefa-mcp
+```
+
+Or in any MCP client config: `{"command": "uvx", "args": ["gamefa-mcp"]}`.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `gf_search_articles` | Search news, reviews and features by keyword, optionally in one section |
+| `gf_latest_articles` | Newest articles, optionally for news, reviews, trailers, pc, playstation, cinema... |
+| `gf_article` | Full article text by id or slug; reviews include score, label, verdict, pros, cons |
+| `gf_reviews` | Latest game reviews with the editors' score out of 10 |
+| `gf_popular` | Most viewed articles of the week, month, season or year |
+| `gf_games` | Game profiles with Gamefa and user scores; sort, search, filter by platform, genre, developer, publisher, release year |
+| `gf_upcoming_games` | Release calendar: unreleased games, soonest first; by month, platform or genre |
+| `gf_game` | One game profile: scores, Metacritic, release, platforms, genres, review link |
+| `gf_films` | Film and series profiles with IMDb and user scores; filter by movie/series, genre, person, studio, country, language, year |
+| `gf_film` | One film or series: cast, director, countries, runtime, scores |
+| `gf_terms` | Look up the slug of a platform, genre, developer, publisher, film person or studio, or an article tag |
+| `gf_comments` | Reader comments (with likes) under an article or a game/film profile |
+| `gf_related` | Articles Gamefa links to a game/film, or similar games/films |
+
+## FAQ
+
+**Does it need an account?** No. **Is it official?** No, it reads the public pages and REST API of gamefa.com.
+**Which network?** Both Iranian and foreign connections reach the site; set `GAMEFA_MCP_PROXY` if yours is blocked.
+
+## فارسی
+
+gamefa-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای سایت گیمفا (gamefa.com) است: جست‌وجوی اخبار و مقالات، متن کامل نقدها همراه با امتیاز، مشخصات و امتیاز بازی‌ها و فیلم‌ها، بازی‌های در راه و پربازدیدترین مطالب. نیازی به کلید API یا حساب کاربری نیست.
+
+---
+
+Made by Sepehr Radmard (سپهر رادمرد): [github.com/sepehr071](https://github.com/sepehr071) · [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.

gamefa_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "gamefa-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for Gamefa (gamefa.com), the Persian game and film site: news, reviews with scores, game and film profiles, upcoming releases."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Sepehr Radmard", email = "sepehrr80@gmail.com" }]
+requires-python = ">=3.10"
+keywords = ["mcp", "model-context-protocol", "gamefa", "gamefa-com", "video-games", "game-reviews", "game-news", "release-calendar", "persian", "farsi", "iran", "cinema", "claude"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "mcp>=2.2,<3",
+    "httpx>=0.27",
+    "httpx-curl-cffi>=0.1.5",
+    "curl-cffi>=0.16.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/sepehr071/gamefa-mcp"
+Issues = "https://github.com/sepehr071/gamefa-mcp/issues"
+Website = "https://mcpfarsi.ir/"
+
+[project.scripts]
+gamefa-mcp = "gamefa_mcp.server:main"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.6"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not live'"
+markers = ["live: calls the real Gamefa site (run with -m live)"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = ["E501"]  # long Field(description=...) strings read better on one line

gamefa_mcp-0.1.0/server.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.sepehr071/gamefa-mcp",
+  "title": "Gamefa",
+  "description": "Read-only Gamefa (gamefa.com) Persian game and film site: news, scored reviews, profiles, releases.",
+  "repository": {
+    "url": "https://github.com/sepehr071/gamefa-mcp",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/sepehr071/gamefa-mcp",
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "gamefa-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "GAMEFA_MCP_PROXY",
+          "description": "Optional HTTP proxy URL for the Gamefa requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.",
+          "isRequired": false,
+          "isSecret": false
+        }
+      ]
+    }
+  ]
+}

gamefa_mcp-0.1.0/src/gamefa_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Unofficial MCP server for Gamefa (gamefa.com), the Persian game and film site: news, reviews, profiles, releases."""
+
+from importlib.metadata import version
+
+__version__ = version("gamefa-mcp")