mcp-proxy-adapter 2.0.2__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.
Files changed (35) hide show
  1. {mcp_proxy_adapter-2.0.2.dist-info → mcp_proxy_adapter-2.1.0.dist-info}/METADATA +47 -13
  2. mcp_proxy_adapter-2.1.0.dist-info/RECORD +28 -0
  3. {mcp_proxy_adapter-2.0.2.dist-info → mcp_proxy_adapter-2.1.0.dist-info}/WHEEL +1 -1
  4. mcp_proxy_adapter-2.1.0.dist-info/top_level.txt +7 -0
  5. mcp_proxy_adapter/__init__.py +0 -17
  6. mcp_proxy_adapter/adapter.py +0 -697
  7. mcp_proxy_adapter/models.py +0 -47
  8. mcp_proxy_adapter/registry.py +0 -439
  9. mcp_proxy_adapter/schema.py +0 -257
  10. mcp_proxy_adapter-2.0.2.dist-info/RECORD +0 -33
  11. mcp_proxy_adapter-2.0.2.dist-info/top_level.txt +0 -1
  12. {mcp_proxy_adapter/adapters → adapters}/__init__.py +0 -0
  13. {mcp_proxy_adapter/analyzers → analyzers}/__init__.py +0 -0
  14. {mcp_proxy_adapter/analyzers → analyzers}/docstring_analyzer.py +0 -0
  15. {mcp_proxy_adapter/analyzers → analyzers}/type_analyzer.py +0 -0
  16. {mcp_proxy_adapter/cli → cli}/__init__.py +0 -0
  17. {mcp_proxy_adapter/cli → cli}/__main__.py +0 -0
  18. {mcp_proxy_adapter/cli → cli}/command_runner.py +0 -0
  19. {mcp_proxy_adapter/dispatchers → dispatchers}/__init__.py +0 -0
  20. {mcp_proxy_adapter/dispatchers → dispatchers}/base_dispatcher.py +0 -0
  21. {mcp_proxy_adapter/dispatchers → dispatchers}/json_rpc_dispatcher.py +0 -0
  22. {mcp_proxy_adapter/generators → generators}/__init__.py +0 -0
  23. {mcp_proxy_adapter/generators → generators}/endpoint_generator.py +0 -0
  24. {mcp_proxy_adapter/generators → generators}/openapi_generator.py +0 -0
  25. {mcp_proxy_adapter/generators → generators}/rest_api_generator.py +0 -0
  26. {mcp_proxy_adapter-2.0.2.dist-info → mcp_proxy_adapter-2.1.0.dist-info}/licenses/LICENSE +0 -0
  27. {mcp_proxy_adapter/openapi_schema → openapi_schema}/__init__.py +0 -0
  28. {mcp_proxy_adapter/openapi_schema → openapi_schema}/command_registry.py +0 -0
  29. {mcp_proxy_adapter/openapi_schema → openapi_schema}/rest_schema.py +0 -0
  30. {mcp_proxy_adapter/openapi_schema → openapi_schema}/rpc_generator.py +0 -0
  31. {mcp_proxy_adapter/openapi_schema → openapi_schema}/rpc_schema.py +0 -0
  32. {mcp_proxy_adapter/validators → validators}/__init__.py +0 -0
  33. {mcp_proxy_adapter/validators → validators}/base_validator.py +0 -0
  34. {mcp_proxy_adapter/validators → validators}/docstring_validator.py +0 -0
  35. {mcp_proxy_adapter/validators → validators}/metadata_validator.py +0 -0
@@ -1,15 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-proxy-adapter
3
- Version: 2.0.2
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)
@@ -0,0 +1,28 @@
1
+ adapters/__init__.py,sha256=7QraK1j5y29KFSRF4mVxTiWC2Y3IYZLd6GhxUCtjyhg,790
2
+ analyzers/__init__.py,sha256=2rcYZDP-bXq078MQpxP32lAwYYyRhOwAQGBcefBfBzY,368
3
+ analyzers/docstring_analyzer.py,sha256=T3FLJEo_uChShfiEKRl8GpVoHvh5HiudZkxnj4KixfA,7541
4
+ analyzers/type_analyzer.py,sha256=6Wac7osKwF03waFSwQ8ZM0Wqn_zAP2D-I4WMEpR0hQM,5230
5
+ cli/__init__.py,sha256=vJ0VTT7D4KRIOi9nQSgBLub7xywq68i2R1zYQkdA0Uk,416
6
+ cli/__main__.py,sha256=qtjEOB4vkeMASjTppyRFok4IFihRrVOqjk6vLx8OW1g,2400
7
+ cli/command_runner.py,sha256=4d0BZKRG9k4CLk3ZE26jfSxwwrls2e-KsflRoVimfyE,8328
8
+ dispatchers/__init__.py,sha256=FWgimgInGphIjCEnvA3-ZExiapUzYAVis2H9C5IWivU,365
9
+ dispatchers/base_dispatcher.py,sha256=S5_Xri058jAmOWeit1tedB_GMZQ9RLcNcYabA83ZF6k,2288
10
+ dispatchers/json_rpc_dispatcher.py,sha256=ffu1M32E1AdC7IB44mlbV2L56eJQMsp-7fYi_r4rmHc,6331
11
+ generators/__init__.py,sha256=KC8p2HcIBqdyCY1wHnN_c1EfbnPM39YhZLNBDcuv3vA,538
12
+ generators/endpoint_generator.py,sha256=fhEInY3JPwdc5EENesN9VrrONwVZMpsledVpubouJLA,6513
13
+ generators/openapi_generator.py,sha256=0Iqsn0fRr10sTWUK9-MU5MXOXKDHccxKYnmaiQPkKFw,9773
14
+ generators/rest_api_generator.py,sha256=Zg9HVeIuspowXd6aBlyho4UXz-te_Hd4egGzjjIVF48,9159
15
+ mcp_proxy_adapter-2.1.0.dist-info/licenses/LICENSE,sha256=OkApFEwdgMCt_mbvUI-eIwKMSTe38K3XnU2DT5ub-wI,1072
16
+ openapi_schema/__init__.py,sha256=S_lEg-VtlgDdhFxB_u9ZUM1dWKbzW_L_FM-6OCT4EXM,1334
17
+ openapi_schema/command_registry.py,sha256=VqqdsVCcd5neqZ-bsfeKTHeLBeputwUZHxvNxVuvqZs,12075
18
+ openapi_schema/rest_schema.py,sha256=nfF9axtmEA-B-Rw8TCnpmRf6Br3MfQ3TJVx-QHUHoy8,24103
19
+ openapi_schema/rpc_generator.py,sha256=5FGMqjMXcaW0Ej6oey5mgiIxtEKTtA87dc-_kWLWqb0,13640
20
+ openapi_schema/rpc_schema.py,sha256=pebSNt9rKyP2dyHpbjSllak6pQe5AnllReKHhR3UIaI,20162
21
+ validators/__init__.py,sha256=s6zd5oZ3V2pXtzONoH3CiZYLzSVtCoLXpETMFUQfwWY,403
22
+ validators/base_validator.py,sha256=qTEcXnfGqsgKKtc-lnttLiPTuq6vOHfDpZrQ5oP5Fi0,602
23
+ validators/docstring_validator.py,sha256=Onpq2iNJ1qF4ejkJJIlBkLROuSNIVALHVmXIgkCpaFI,2934
24
+ validators/metadata_validator.py,sha256=uCrn38-VYYn89l6f5CC_GoTAHAweaOW2Z6Esro1rtGw,3155
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
 
@@ -0,0 +1,7 @@
1
+ adapters
2
+ analyzers
3
+ cli
4
+ dispatchers
5
+ generators
6
+ openapi_schema
7
+ validators
@@ -1,17 +0,0 @@
1
- """
2
- MCP Proxy Adapter
3
- =================
4
-
5
- Adapter for integrating Command Registry with MCP Proxy to use commands as tools
6
- for AI models.
7
- """
8
-
9
- # Package version
10
- __version__ = '2.0.0'
11
-
12
- # Public API
13
- from .adapter import MCPProxyAdapter, configure_logger
14
- from .models import MCPProxyConfig, MCPProxyTool, CommandInfo, CommandParameter
15
-
16
- __all__ = ['MCPProxyAdapter', 'configure_logger', 'MCPProxyConfig', 'MCPProxyTool',
17
- 'CommandInfo', 'CommandParameter']