mcp-proxy-adapter 2.0.1__py3-none-any.whl → 2.1.0__py3-none-any.whl

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.
@@ -1,15 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-proxy-adapter
3
- Version: 2.0.1
3
+ Version: 2.1.0
4
4
  Summary: Adapter for exposing Command Registry commands as tools for AI models via MCP Proxy.
5
5
  Home-page: https://github.com/vasilyvz/mcp-proxy-adapter
6
6
  Author: Vasiliy VZ
7
7
  Author-email: Vasiliy VZ <vasilyvz@example.com>
8
8
  License: MIT
9
9
  Project-URL: Homepage, https://github.com/vasilyvz/mcp-proxy-adapter
10
- Project-URL: BugTracker, https://github.com/vasilyvz/mcp-proxy-adapter/issues
11
- Project-URL: Documentation, https://github.com/vasilyvz/mcp_proxy_adapter#readme
12
- Project-URL: Source, https://github.com/vasilyvz/mcp_proxy_adapter
10
+ Project-URL: Bug Tracker, https://github.com/vasilyvz/mcp-proxy-adapter/issues
11
+ Project-URL: Documentation, https://github.com/vasilyvz/mcp-proxy-adapter/tree/main/docs
13
12
  Classifier: Development Status :: 4 - Beta
14
13
  Classifier: Intended Audience :: Developers
15
14
  Classifier: License :: OSI Approved :: MIT License
@@ -22,7 +21,7 @@ Requires-Python: >=3.9, <4
22
21
  Description-Content-Type: text/markdown
23
22
  License-File: LICENSE
24
23
  Requires-Dist: fastapi<1.0.0,>=0.95.0
25
- Requires-Dist: pydantic<3.0.0,>=2.0.0
24
+ Requires-Dist: pydantic<2.0.0,>=1.10.0
26
25
  Requires-Dist: uvicorn<1.0.0,>=0.22.0
27
26
  Requires-Dist: docstring-parser<1.0.0,>=0.15
28
27
  Requires-Dist: typing-extensions<5.0.0,>=4.5.0
@@ -262,11 +261,46 @@ MIT
262
261
  ## Documentation
263
262
  See [docs/](docs/) for detailed guides, architecture, and examples.
264
263
 
265
- ## CI/CD & PyPI automation
266
-
267
- This project uses GitHub Actions for continuous integration and automated publishing to PyPI.
268
-
269
- - All tests are run on every push and pull request.
270
- - On push of a new tag (vX.Y.Z), the package is built and published to PyPI automatically.
271
-
272
- See `.github/workflows/publish.yml` for details.
264
+ ## 📦 Примеры (examples/)
265
+
266
+ - `help_usage.py` базовое использование help-команды
267
+ - `help_best_practices.py` — best practices для help
268
+ - `project_structure_example.py` структура проекта с MCPProxyAdapter
269
+ - `docstring_and_schema_example.py` как документировать команды для схемы
270
+ - `testing_example.py` — как тестировать команды и интеграцию
271
+ - `extension_example.py` как расширять и кастомизировать команды и help
272
+
273
+ ## ✅ Чеклист для добавления новой команды
274
+
275
+ 1. **Реализовать функцию-команду** с подробным docstring (EN)
276
+ 2. **Добавить описание параметров** (type, description, required)
277
+ 3. **Добавить описание возврата** (docstring, тип)
278
+ 4. **Зарегистрировать команду** в registry/dispatcher
279
+ 5. **Добавить описание в get_commands_info** (использовать docstring)
280
+ 6. **Покрыть тестами** (unit/integration, edge-cases, ошибки)
281
+ 7. **Добавить пример использования** в examples/
282
+ 8. **Проверить интеграцию с help** (и с параметром, и без)
283
+ 9. **Проверить генерацию схемы/OpenAPI**
284
+ 10. **Документировать в README.md** (EN/RU)
285
+
286
+ ## 📦 Examples (EN)
287
+
288
+ - `help_usage.py` — basic help command usage
289
+ - `help_best_practices.py` — best practices for help
290
+ - `project_structure_example.py` — project structure with MCPProxyAdapter
291
+ - `docstring_and_schema_example.py` — how to document commands for schema
292
+ - `testing_example.py` — how to test commands and integration
293
+ - `extension_example.py` — how to extend/customize commands and help
294
+
295
+ ## ✅ Checklist for adding a new command
296
+
297
+ 1. **Implement the command function** with detailed docstring (EN)
298
+ 2. **Describe parameters** (type, description, required)
299
+ 3. **Describe return value** (docstring, type)
300
+ 4. **Register the command** in registry/dispatcher
301
+ 5. **Add description to get_commands_info** (use docstring)
302
+ 6. **Cover with tests** (unit/integration, edge-cases, errors)
303
+ 7. **Add usage example** to examples/
304
+ 8. **Check help integration** (with/without param)
305
+ 9. **Check schema/OpenAPI generation**
306
+ 10. **Document in README.md** (EN/RU)
@@ -12,7 +12,7 @@ generators/__init__.py,sha256=KC8p2HcIBqdyCY1wHnN_c1EfbnPM39YhZLNBDcuv3vA,538
12
12
  generators/endpoint_generator.py,sha256=fhEInY3JPwdc5EENesN9VrrONwVZMpsledVpubouJLA,6513
13
13
  generators/openapi_generator.py,sha256=0Iqsn0fRr10sTWUK9-MU5MXOXKDHccxKYnmaiQPkKFw,9773
14
14
  generators/rest_api_generator.py,sha256=Zg9HVeIuspowXd6aBlyho4UXz-te_Hd4egGzjjIVF48,9159
15
- mcp_proxy_adapter-2.0.1.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
15
+ mcp_proxy_adapter-2.1.0.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
16
16
  openapi_schema/__init__.py,sha256=S_lEg-VtlgDdhFxB_u9ZUM1dWKbzW_L_FM-6OCT4EXM,1334
17
17
  openapi_schema/command_registry.py,sha256=VqqdsVCcd5neqZ-bsfeKTHeLBeputwUZHxvNxVuvqZs,12075
18
18
  openapi_schema/rest_schema.py,sha256=nfF9axtmEA-B-Rw8TCnpmRf6Br3MfQ3TJVx-QHUHoy8,24103
@@ -22,7 +22,7 @@ validators/__init__.py,sha256=s6zd5oZ3V2pXtzONoH3CiZYLzSVtCoLXpETMFUQfwWY,403
22
22
  validators/base_validator.py,sha256=qTEcXnfGqsgKKtc-lnttLiPTuq6vOHfDpZrQ5oP5Fi0,602
23
23
  validators/docstring_validator.py,sha256=Onpq2iNJ1qF4ejkJJIlBkLROuSNIVALHVmXIgkCpaFI,2934
24
24
  validators/metadata_validator.py,sha256=uCrn38-VYYn89l6f5CC_GoTAHAweaOW2Z6Esro1rtGw,3155
25
- mcp_proxy_adapter-2.0.1.dist-info/METADATA,sha256=oP9RxZPEOhQdF_fPbj0t3gyN8u6lWRZBMETQ1gXno_k,6076
26
- mcp_proxy_adapter-2.0.1.dist-info/WHEEL,sha256=ooBFpIzZCPdw3uqIQsOo4qqbA4ZRPxHnOH7peeONza0,91
27
- mcp_proxy_adapter-2.0.1.dist-info/top_level.txt,sha256=SlVzE4ry_0xTgDmO2uiaI7ihb9MpR62izN4MH_t1BTU,72
28
- mcp_proxy_adapter-2.0.1.dist-info/RECORD,,
25
+ mcp_proxy_adapter-2.1.0.dist-info/METADATA,sha256=NzrDAS6Q9E1vrPY-xzm72Uq09hncset_5NrFyIYPDvc,8158
26
+ mcp_proxy_adapter-2.1.0.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
27
+ mcp_proxy_adapter-2.1.0.dist-info/top_level.txt,sha256=SlVzE4ry_0xTgDmO2uiaI7ihb9MpR62izN4MH_t1BTU,72
28
+ mcp_proxy_adapter-2.1.0.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (80.0.1)
2
+ Generator: setuptools (80.1.0)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5