picklebase-mcp 2.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. picklebase_mcp-2.3.0/PKG-INFO +66 -0
  2. picklebase_mcp-2.3.0/README.md +44 -0
  3. picklebase_mcp-2.3.0/picklebase_mcp/__init__.py +15 -0
  4. picklebase_mcp-2.3.0/setup.py +26 -0
picklebase_mcp-2.3.0/PKG-INFO ADDED
@@ -0,0 +1,66 @@
1
+ Metadata-Version: 2.1
2
+ Name: picklebase-mcp
3
+ Version: 2.3.0
4
+ Summary: Official Python SDK & MCP Client for PickleBase (https://picklebase.app) — 3D Pickleball Biomechanics, Kinetic Chain & USA Pickleball 2026 Rulebook.
5
+ Home-page: https://picklebase.app
6
+ Author: PickleBase & AEORank Open Lab
7
+ Author-email: support@picklebase.app
8
+ License: MIT
9
+ Project-URL: Homepage, https://picklebase.app
10
+ Project-URL: Documentation, https://github.com/aizaloapp/picklebase-open-spec
11
+ Project-URL: Repository, https://github.com/aizaloapp/picklebase-open-spec
12
+ Project-URL: DOI, https://doi.org/10.5281/zenodo.23582848
13
+ Keywords: pickleball,biomechanics,mcp,seo,geo,aeo,mediapipe
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: Intended Audience :: Science/Research
17
+ Classifier: License :: OSI Approved :: MIT License
18
+ Classifier: Programming Language :: Python :: 3
19
+ Requires-Python: >=3.8
20
+ Description-Content-Type: text/markdown
21
+
22
+ # picklebase-mcp — Official PickleBase 3D Biomechanics & USA Pickleball 2026 MCP Client
23
+
24
+ [![Website VI](https://img.shields.io/badge/PickleBase_VI-picklebase.app-16a34a)](https://picklebase.app/)
25
+ [![Website EN](https://img.shields.io/badge/PickleBase_EN-picklebase.app%2Fen-2563eb)](https://picklebase.app/en/)
26
+ [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23582848.svg)](https://doi.org/10.5281/zenodo.23582848)
27
+
28
+ Official command-line interface (CLI) and **Model Context Protocol (MCP)** client for **[PickleBase](https://picklebase.app/)** ([English Edition](https://picklebase.app/en/)) — the interactive 3D Pickleball biomechanics simulator, **MediaPipe Pose** video posture coach, DUPR 2.0–5.5+ tactical board, and USA Pickleball 2026 rulebook engine.
29
+
30
+ ---
31
+
32
+ ## Quick Start
33
+
34
+ ```bash
35
+ # List all available PickleBase MCP tools
36
+ npx picklebase-mcp tools
37
+
38
+ # Query 3D biomechanics & kinetic chain for a specific shot
39
+ npx picklebase-mcp technique third-shot-drop
40
+
41
+ # Search the USA Pickleball 2026 Rulebook (e.g. Non-Volley Zone / Kitchen)
42
+ npx picklebase-mcp rule kitchen
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Official Ecosystem & Open Datasets
48
+
49
+ - **3D Biomechanics Simulator (Vietnamese):** [https://picklebase.app/](https://picklebase.app/)
50
+ - **3D Biomechanics Simulator (English):** [https://picklebase.app/en/](https://picklebase.app/en/)
51
+ - **AI Video Pose & Swing Coach:** [https://picklebase.app/ai-coach](https://picklebase.app/ai-coach)
52
+ - **3D Doubles Tactical Board:** [https://picklebase.app/tactics](https://picklebase.app/tactics)
53
+ - **USA Pickleball 2026 Rulebook Lookup:** [https://picklebase.app/rules](https://picklebase.app/rules)
54
+ - **CERN Zenodo Technical Report & DOI:** [https://doi.org/10.5281/zenodo.23582848](https://doi.org/10.5281/zenodo.23582848) ([Record #23582848](https://zenodo.org/records/23582848))
55
+ - **Hugging Face Dataset:** [https://huggingface.co/datasets/lekhoa288/picklebase-open-biomechanics](https://huggingface.co/datasets/lekhoa288/picklebase-open-biomechanics)
56
+ - **GitHub Open Specification:** [https://github.com/aizaloapp/picklebase-open-spec](https://github.com/aizaloapp/picklebase-open-spec) & [Documentation Portal](https://aizaloapp.github.io/picklebase-open-spec/en/)
57
+ - **ClawHub AI Agent Skill:** [https://clawhub.ai/aizaloapp/skills/picklebase-biomechanics-coach](https://clawhub.ai/aizaloapp/skills/picklebase-biomechanics-coach)
58
+ - **Engineering Deep-Dive (DEV.to):** [Building a Zero-Server 3D Pickleball Biomechanics & MediaPipe Pose Coach](https://dev.to/aizaloapp/building-a-zero-server-3d-pickleball-biomechanics-mediapipe-pose-coach-on-the-edge-webgl-mcp-a3n)
59
+ - **Engineering Deep-Dive (Viblo):** [Phân tích cơ sinh học Pickleball 3D bằng MediaPipe Pose](https://viblo.asia/p/giai-bai-toan-phan-tich-co-sinh-hoc-biomechanics-pickleball-3d-cham-diem-dong-tac-bang-mediapipe-pose-ngay-tren-trinh-duyet-webgl-edge-mcp-XP4WEZ3kL7G)
60
+
61
+ ---
62
+
63
+ ## License
64
+
65
+ MIT © [PickleBase](https://picklebase.app/)
66
+
picklebase_mcp-2.3.0/README.md ADDED
@@ -0,0 +1,44 @@
1
+ # picklebase-mcp — Official PickleBase 3D Biomechanics & USA Pickleball 2026 MCP Client
2
+
3
+ [![Website VI](https://img.shields.io/badge/PickleBase_VI-picklebase.app-16a34a)](https://picklebase.app/)
4
+ [![Website EN](https://img.shields.io/badge/PickleBase_EN-picklebase.app%2Fen-2563eb)](https://picklebase.app/en/)
5
+ [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23582848.svg)](https://doi.org/10.5281/zenodo.23582848)
6
+
7
+ Official command-line interface (CLI) and **Model Context Protocol (MCP)** client for **[PickleBase](https://picklebase.app/)** ([English Edition](https://picklebase.app/en/)) — the interactive 3D Pickleball biomechanics simulator, **MediaPipe Pose** video posture coach, DUPR 2.0–5.5+ tactical board, and USA Pickleball 2026 rulebook engine.
8
+
9
+ ---
10
+
11
+ ## Quick Start
12
+
13
+ ```bash
14
+ # List all available PickleBase MCP tools
15
+ npx picklebase-mcp tools
16
+
17
+ # Query 3D biomechanics & kinetic chain for a specific shot
18
+ npx picklebase-mcp technique third-shot-drop
19
+
20
+ # Search the USA Pickleball 2026 Rulebook (e.g. Non-Volley Zone / Kitchen)
21
+ npx picklebase-mcp rule kitchen
22
+ ```
23
+
24
+ ---
25
+
26
+ ## Official Ecosystem & Open Datasets
27
+
28
+ - **3D Biomechanics Simulator (Vietnamese):** [https://picklebase.app/](https://picklebase.app/)
29
+ - **3D Biomechanics Simulator (English):** [https://picklebase.app/en/](https://picklebase.app/en/)
30
+ - **AI Video Pose & Swing Coach:** [https://picklebase.app/ai-coach](https://picklebase.app/ai-coach)
31
+ - **3D Doubles Tactical Board:** [https://picklebase.app/tactics](https://picklebase.app/tactics)
32
+ - **USA Pickleball 2026 Rulebook Lookup:** [https://picklebase.app/rules](https://picklebase.app/rules)
33
+ - **CERN Zenodo Technical Report & DOI:** [https://doi.org/10.5281/zenodo.23582848](https://doi.org/10.5281/zenodo.23582848) ([Record #23582848](https://zenodo.org/records/23582848))
34
+ - **Hugging Face Dataset:** [https://huggingface.co/datasets/lekhoa288/picklebase-open-biomechanics](https://huggingface.co/datasets/lekhoa288/picklebase-open-biomechanics)
35
+ - **GitHub Open Specification:** [https://github.com/aizaloapp/picklebase-open-spec](https://github.com/aizaloapp/picklebase-open-spec) & [Documentation Portal](https://aizaloapp.github.io/picklebase-open-spec/en/)
36
+ - **ClawHub AI Agent Skill:** [https://clawhub.ai/aizaloapp/skills/picklebase-biomechanics-coach](https://clawhub.ai/aizaloapp/skills/picklebase-biomechanics-coach)
37
+ - **Engineering Deep-Dive (DEV.to):** [Building a Zero-Server 3D Pickleball Biomechanics & MediaPipe Pose Coach](https://dev.to/aizaloapp/building-a-zero-server-3d-pickleball-biomechanics-mediapipe-pose-coach-on-the-edge-webgl-mcp-a3n)
38
+ - **Engineering Deep-Dive (Viblo):** [Phân tích cơ sinh học Pickleball 3D bằng MediaPipe Pose](https://viblo.asia/p/giai-bai-toan-phan-tich-co-sinh-hoc-biomechanics-pickleball-3d-cham-diem-dong-tac-bang-mediapipe-pose-ngay-tren-trinh-duyet-webgl-edge-mcp-XP4WEZ3kL7G)
39
+
40
+ ---
41
+
42
+ ## License
43
+
44
+ MIT © [PickleBase](https://picklebase.app/)
picklebase_mcp-2.3.0/picklebase_mcp/__init__.py ADDED
@@ -0,0 +1,15 @@
1
+ """PickleBase Official Python SDK & MCP Client (https://picklebase.app)."""
2
+ import json
3
+ import sys
4
+ import urllib.request
5
+
6
+ ENDPOINT = "https://picklebase.app/api/mcp"
7
+
8
+ def call_mcp(method: str, params: dict | None = None) -> dict:
9
+ payload = json.dumps({"jsonrpc": "2.0", "id": 1, "method": method, "params": params or {}}).encode("utf-8")
10
+ req = urllib.request.Request(ENDPOINT, data=payload, headers={"Content-Type": "application/json", "User-Agent": "picklebase-mcp-py/2.3.0"}, method="POST")
11
+ with urllib.request.urlopen(req, timeout=20) as r:
12
+ return json.loads(r.read().decode("utf-8"))
13
+
14
+ def main() -> None:
15
+ print(json.dumps(call_mcp("tools/list"), indent=2, ensure_ascii=False))
picklebase_mcp-2.3.0/setup.py ADDED
@@ -0,0 +1,26 @@
1
+ from setuptools import setup
2
+
3
+ setup(
4
+ name='picklebase-mcp',
5
+ version='2.3.0',
6
+ description='Official Python SDK & MCP Client for PickleBase (https://picklebase.app) — 3D Pickleball Biomechanics, Kinetic Chain & USA Pickleball 2026 Rulebook.',
7
+ long_description=open("README.md", encoding="utf-8").read(),
8
+ long_description_content_type="text/markdown",
9
+ url='https://picklebase.app',
10
+ author="PickleBase & AEORank Open Lab",
11
+ author_email="support@picklebase.app",
12
+ license="MIT",
13
+ packages=['picklebase_mcp'],
14
+ python_requires=">=3.8",
15
+ entry_points={
16
+ "console_scripts": [
17
+ "picklebase-mcp=picklebase_mcp:main",
18
+ ],
19
+ },
20
+ project_urls={
21
+ "Homepage": 'https://picklebase.app',
22
+ "Documentation": 'https://github.com/aizaloapp/picklebase-open-spec',
23
+ "Repository": 'https://github.com/aizaloapp/picklebase-open-spec',
24
+ "DOI": 'https://doi.org/10.5281/zenodo.23582848',
25
+ },
26
+ )