toolregistry-server 0.1.0__tar.gz

toolregistry_server-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Oaklight
+
+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.

toolregistry_server-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: toolregistry-server
+Version: 0.1.0
+Summary: Define custom tools and serve them via OpenAPI or MCP interfaces
+Author-email: Oaklight <pding.sam@gmail.com>
+License-Expression: MIT
+Project-URL: Documentation, https://toolregistry-server.readthedocs.io
+Project-URL: Repository, https://github.com/Oaklight/toolregistry-server
+Project-URL: Issues, https://github.com/Oaklight/toolregistry-server/issues
+Project-URL: Changelog, https://github.com/Oaklight/toolregistry-server/blob/main/CHANGELOG.md
+Keywords: toolregistry,mcp,openapi,fastapi,server,llm,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: toolregistry>=0.5.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: openapi
+Requires-Dist: fastapi>=0.119.0; extra == "openapi"
+Requires-Dist: uvicorn[standard]>=0.24.0; extra == "openapi"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.8.0; extra == "mcp"
+Provides-Extra: all
+Requires-Dist: toolregistry-server[openapi]; extra == "all"
+Requires-Dist: toolregistry-server[mcp]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: ty>=0.0.21; extra == "dev"
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: twine>=6.1.0; extra == "dev"
+Dynamic: license-file
+
+# toolregistry-server
+
+[![PyPI version](https://badge.fury.io/py/toolregistry-server.svg)](https://badge.fury.io/py/toolregistry-server)
+[![Python Version](https://img.shields.io/pypi/pyversions/toolregistry-server.svg)](https://pypi.org/project/toolregistry-server/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Define custom tools and serve them via OpenAPI or MCP interfaces. Built on [ToolRegistry](https://github.com/Oaklight/ToolRegistry).
+
+## Overview
+
+`toolregistry-server` lets you register Python functions as tools and expose them as services through multiple protocols. It provides:
+
+- **Central Route Table**: A unified routing layer that bridges `ToolRegistry` and protocol adapters
+- **OpenAPI Adapter**: Expose tools as RESTful HTTP endpoints with automatic OpenAPI schema generation
+- **MCP Adapter**: Expose tools via the [Model Context Protocol](https://modelcontextprotocol.io/) for LLM integration
+- **Authentication**: Built-in Bearer token authentication support
+- **CLI**: Command-line interface for running servers
+
+## Ecosystem
+
+The ToolRegistry ecosystem consists of three packages:
+
+| Package | Description | Repository |
+|---------|-------------|------------|
+| [`toolregistry`](https://pypi.org/project/toolregistry/) | Core library - Tool model, ToolRegistry, client integration | [Oaklight/ToolRegistry](https://github.com/Oaklight/ToolRegistry) |
+| [`toolregistry-server`](https://pypi.org/project/toolregistry-server/) | Tool server - define tools and serve via OpenAPI/MCP | [Oaklight/toolregistry-server](https://github.com/Oaklight/toolregistry-server) |
+| [`toolregistry-hub`](https://pypi.org/project/toolregistry-hub/) | Tool collection - Built-in tools, default server configuration | [Oaklight/toolregistry-hub](https://github.com/Oaklight/toolregistry-hub) |
+
+```
+toolregistry (core)
+       ↓
+toolregistry-server (tool server)
+       ↓
+toolregistry-hub (tool collection + server config)
+```
+
+## Installation
+
+### Basic Installation
+
+```bash
+pip install toolregistry-server
+```
+
+### With OpenAPI Support
+
+```bash
+pip install toolregistry-server[openapi]
+```
+
+### With MCP Support
+
+```bash
+pip install toolregistry-server[mcp]
+```
+
+### Full Installation
+
+```bash
+pip install toolregistry-server[all]
+```
+
+## Quick Start
+
+### Using RouteTable
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+
+# Create a registry and register tools
+registry = ToolRegistry()
+
+@registry.register
+def greet(name: str) -> str:
+    """Greet someone by name."""
+    return f"Hello, {name}!"
+
+# Create a route table
+route_table = RouteTable(registry)
+
+# List all routes
+for route in route_table.list_routes():
+    print(f"{route.path} -> {route.tool_name}")
+```
+
+### Creating an OpenAPI Server
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+from toolregistry_server.openapi import create_openapi_app
+
+# Setup registry and route table
+registry = ToolRegistry()
+# ... register tools ...
+route_table = RouteTable(registry)
+
+# Create FastAPI app
+app = create_openapi_app(route_table)
+
+# Run with uvicorn
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+### Creating an MCP Server
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+from toolregistry_server.mcp import create_mcp_server
+
+# Setup registry and route table
+registry = ToolRegistry()
+# ... register tools ...
+route_table = RouteTable(registry)
+
+# Create MCP server
+server = create_mcp_server(route_table)
+
+# Run the server
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(server.run())
+```
+
+### Using the CLI
+
+```bash
+# Start OpenAPI server
+toolregistry-server --mode openapi --port 8000
+
+# Start MCP server (stdio)
+toolregistry-server --mode mcp
+
+# With authentication
+toolregistry-server --mode openapi --auth-token "your-secret-token"
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      ToolRegistry                           │
+│                   (tool definitions)                        │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│                       RouteTable                            │
+│              (central routing layer)                        │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │ RouteEntry  │  │ RouteEntry  │  │ RouteEntry  │  ...    │
+│  └─────────────┘  └─────────────┘  └─────────────┘         │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+          ┌───────────────┼───────────────┐
+          ▼               ▼               ▼
+┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
+│ OpenAPI Adapter │ │   MCP Adapter   │ │  gRPC Adapter   │
+│   (FastAPI)     │ │   (MCP SDK)     │ │    (future)     │
+└─────────────────┘ └─────────────────┘ └─────────────────┘
+          │               │               │
+          ▼               ▼               ▼
+┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
+│  HTTP Clients   │ │   MCP Clients   │ │  gRPC Clients   │
+└─────────────────┘ └─────────────────┘ └─────────────────┘
+```
+
+## Documentation
+
+- [Full Documentation](https://toolregistry-server.readthedocs.io)
+- [API Reference](https://toolregistry-server.readthedocs.io/api/)
+- [Examples](https://toolregistry-server.readthedocs.io/examples/)
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [ToolRegistry](https://github.com/Oaklight/ToolRegistry) - Core library
+- [toolregistry-hub](https://github.com/Oaklight/toolregistry-hub) - Built-in tool collection
+- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification

toolregistry_server-0.1.0/README.md

@@ -0,0 +1,190 @@
+# toolregistry-server
+
+[![PyPI version](https://badge.fury.io/py/toolregistry-server.svg)](https://badge.fury.io/py/toolregistry-server)
+[![Python Version](https://img.shields.io/pypi/pyversions/toolregistry-server.svg)](https://pypi.org/project/toolregistry-server/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Define custom tools and serve them via OpenAPI or MCP interfaces. Built on [ToolRegistry](https://github.com/Oaklight/ToolRegistry).
+
+## Overview
+
+`toolregistry-server` lets you register Python functions as tools and expose them as services through multiple protocols. It provides:
+
+- **Central Route Table**: A unified routing layer that bridges `ToolRegistry` and protocol adapters
+- **OpenAPI Adapter**: Expose tools as RESTful HTTP endpoints with automatic OpenAPI schema generation
+- **MCP Adapter**: Expose tools via the [Model Context Protocol](https://modelcontextprotocol.io/) for LLM integration
+- **Authentication**: Built-in Bearer token authentication support
+- **CLI**: Command-line interface for running servers
+
+## Ecosystem
+
+The ToolRegistry ecosystem consists of three packages:
+
+| Package | Description | Repository |
+|---------|-------------|------------|
+| [`toolregistry`](https://pypi.org/project/toolregistry/) | Core library - Tool model, ToolRegistry, client integration | [Oaklight/ToolRegistry](https://github.com/Oaklight/ToolRegistry) |
+| [`toolregistry-server`](https://pypi.org/project/toolregistry-server/) | Tool server - define tools and serve via OpenAPI/MCP | [Oaklight/toolregistry-server](https://github.com/Oaklight/toolregistry-server) |
+| [`toolregistry-hub`](https://pypi.org/project/toolregistry-hub/) | Tool collection - Built-in tools, default server configuration | [Oaklight/toolregistry-hub](https://github.com/Oaklight/toolregistry-hub) |
+
+```
+toolregistry (core)
+       ↓
+toolregistry-server (tool server)
+       ↓
+toolregistry-hub (tool collection + server config)
+```
+
+## Installation
+
+### Basic Installation
+
+```bash
+pip install toolregistry-server
+```
+
+### With OpenAPI Support
+
+```bash
+pip install toolregistry-server[openapi]
+```
+
+### With MCP Support
+
+```bash
+pip install toolregistry-server[mcp]
+```
+
+### Full Installation
+
+```bash
+pip install toolregistry-server[all]
+```
+
+## Quick Start
+
+### Using RouteTable
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+
+# Create a registry and register tools
+registry = ToolRegistry()
+
+@registry.register
+def greet(name: str) -> str:
+    """Greet someone by name."""
+    return f"Hello, {name}!"
+
+# Create a route table
+route_table = RouteTable(registry)
+
+# List all routes
+for route in route_table.list_routes():
+    print(f"{route.path} -> {route.tool_name}")
+```
+
+### Creating an OpenAPI Server
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+from toolregistry_server.openapi import create_openapi_app
+
+# Setup registry and route table
+registry = ToolRegistry()
+# ... register tools ...
+route_table = RouteTable(registry)
+
+# Create FastAPI app
+app = create_openapi_app(route_table)
+
+# Run with uvicorn
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+### Creating an MCP Server
+
+```python
+from toolregistry import ToolRegistry
+from toolregistry_server import RouteTable
+from toolregistry_server.mcp import create_mcp_server
+
+# Setup registry and route table
+registry = ToolRegistry()
+# ... register tools ...
+route_table = RouteTable(registry)
+
+# Create MCP server
+server = create_mcp_server(route_table)
+
+# Run the server
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(server.run())
+```
+
+### Using the CLI
+
+```bash
+# Start OpenAPI server
+toolregistry-server --mode openapi --port 8000
+
+# Start MCP server (stdio)
+toolregistry-server --mode mcp
+
+# With authentication
+toolregistry-server --mode openapi --auth-token "your-secret-token"
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      ToolRegistry                           │
+│                   (tool definitions)                        │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│                       RouteTable                            │
+│              (central routing layer)                        │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │ RouteEntry  │  │ RouteEntry  │  │ RouteEntry  │  ...    │
+│  └─────────────┘  └─────────────┘  └─────────────┘         │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+          ┌───────────────┼───────────────┐
+          ▼               ▼               ▼
+┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
+│ OpenAPI Adapter │ │   MCP Adapter   │ │  gRPC Adapter   │
+│   (FastAPI)     │ │   (MCP SDK)     │ │    (future)     │
+└─────────────────┘ └─────────────────┘ └─────────────────┘
+          │               │               │
+          ▼               ▼               ▼
+┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
+│  HTTP Clients   │ │   MCP Clients   │ │  gRPC Clients   │
+└─────────────────┘ └─────────────────┘ └─────────────────┘
+```
+
+## Documentation
+
+- [Full Documentation](https://toolregistry-server.readthedocs.io)
+- [API Reference](https://toolregistry-server.readthedocs.io/api/)
+- [Examples](https://toolregistry-server.readthedocs.io/examples/)
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [ToolRegistry](https://github.com/Oaklight/ToolRegistry) - Core library
+- [toolregistry-hub](https://github.com/Oaklight/toolregistry-hub) - Built-in tool collection
+- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification

toolregistry_server-0.1.0/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "toolregistry-server"
+dynamic = ["version"]
+description = "Define custom tools and serve them via OpenAPI or MCP interfaces"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "Oaklight", email = "pding.sam@gmail.com" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "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 :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
+]
+keywords = [
+    "toolregistry",
+    "mcp",
+    "openapi",
+    "fastapi",
+    "server",
+    "llm",
+    "tools",
+]
+dependencies = ["toolregistry>=0.5.0", "loguru>=0.7.0", "python-dotenv>=1.0.0"]
+
+[project.optional-dependencies]
+openapi = ["fastapi>=0.119.0", "uvicorn[standard]>=0.24.0"]
+mcp = ["mcp>=1.8.0"]
+all = ["toolregistry-server[openapi]", "toolregistry-server[mcp]"]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "httpx>=0.24.0",
+    "ruff>=0.1.0",
+    "ty>=0.0.21",
+    "build>=1.2.0",
+    "twine>=6.1.0",
+]
+
+[project.scripts]
+toolregistry-server = "toolregistry_server.cli:main"
+
+[project.urls]
+Documentation = "https://toolregistry-server.readthedocs.io"
+Repository = "https://github.com/Oaklight/toolregistry-server"
+Issues = "https://github.com/Oaklight/toolregistry-server/issues"
+Changelog = "https://github.com/Oaklight/toolregistry-server/blob/main/CHANGELOG.md"
+
+[tool.setuptools.dynamic]
+version = { attr = "toolregistry_server.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"toolregistry_server" = ["py.typed"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.ty.environment]
+python-version = "3.10"
+
+[tool.ty.src]
+include = ["src", "tests"]
+
+[tool.ty.rules]
+unresolved-import = "ignore"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]

toolregistry_server-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

toolregistry_server-0.1.0/src/toolregistry_server/__init__.py

@@ -0,0 +1,34 @@
+"""
+toolregistry-server: Define custom tools and serve them via OpenAPI or MCP.
+
+This package lets you register Python functions as tools and expose them
+as services via OpenAPI (REST) and MCP (Model Context Protocol) interfaces.
+
+Main Components:
+    - RouteTable: Central routing layer that bridges ToolRegistry and protocol adapters
+    - openapi: OpenAPI/REST adapter using FastAPI
+    - mcp: MCP adapter for LLM integration
+    - auth: Authentication utilities
+    - cli: Command-line interface
+
+Example:
+    ```python
+    from toolregistry import ToolRegistry
+    from toolregistry_server import RouteTable
+
+    registry = ToolRegistry()
+    route_table = RouteTable(registry)
+    for route in route_table.list_routes():
+        print(route.path)
+    ```
+"""
+
+__version__ = "0.1.0"
+
+from .route_table import RouteEntry, RouteTable
+
+__all__ = [
+    "__version__",
+    "RouteTable",
+    "RouteEntry",
+]