universal-mcp 0.1.15rc5__py3-none-any.whl → 0.1.16__py3-none-any.whl

universal_mcp-0.1.15rc5.dist-info/METADATA

@@ -1,245 +0,0 @@
-Metadata-Version: 2.4
-Name: universal-mcp
-Version: 0.1.15rc5
-Summary: Universal MCP acts as a middle ware for your API applications. It can store your credentials, authorize, enable disable apps on the fly and much more.
-Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
-License: MIT
-Requires-Python: >=3.11
-Requires-Dist: cookiecutter>=2.6.0
-Requires-Dist: gql[all]>=3.5.2
-Requires-Dist: jinja2>=3.1.3
-Requires-Dist: jsonref>=1.1.0
-Requires-Dist: keyring>=25.6.0
-Requires-Dist: litellm>=1.30.7
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.6.0
-Requires-Dist: posthog>=3.24.0
-Requires-Dist: pydantic-settings>=2.8.1
-Requires-Dist: pydantic>=2.11.1
-Requires-Dist: pyyaml>=6.0.2
-Requires-Dist: rich>=14.0.0
-Requires-Dist: typer>=0.15.2
-Provides-Extra: dev
-Requires-Dist: litellm>=1.30.7; extra == 'dev'
-Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
-Requires-Dist: pyright>=1.1.398; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
-Requires-Dist: pytest>=8.3.5; extra == 'dev'
-Requires-Dist: ruff>=0.11.4; extra == 'dev'
-Provides-Extra: playground
-Requires-Dist: langchain-mcp-adapters>=0.0.3; extra == 'playground'
-Requires-Dist: langchain-openai>=0.3.12; extra == 'playground'
-Requires-Dist: langgraph-checkpoint-sqlite>=2.0.6; extra == 'playground'
-Requires-Dist: langgraph>=0.3.24; extra == 'playground'
-Requires-Dist: python-dotenv>=1.0.1; extra == 'playground'
-Requires-Dist: streamlit>=1.44.1; extra == 'playground'
-Requires-Dist: watchdog>=6.0.0; extra == 'playground'
-Description-Content-Type: text/markdown
-
-# Universal MCP
-Universal MCP acts as a middleware layer for your API applications, enabling seamless integration with various services through the Model Context Protocol (MCP). It simplifies credential management, authorization, and dynamic app enablement.
-
-## 🌟 Features
-
-- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
-- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
-- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
-- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
-- **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
-- **Tool Management**: Comprehensive tool registration, validation, and execution capabilities
-- **Multiple Server Types**: Support for local, AgentR, and single-application server configurations
-
-## 🔧 Installation
-
-Install Universal MCP using pip:
-
-```bash
-pip install universal-mcp
-```
-
-## 🚀 Quick Start
-
-**Important Prerequisite: AgentR API Key (If Using AgentR Integration)**
-
-If you plan to use integrations with `type: "agentr"` (for services like GitHub, Gmail, Notion via the AgentR platform), or if you run the server with `type: "agentr"`, you first need an AgentR API key:
-
-1.  Visit [https://agentr.dev](https://agentr.dev) to create an account and generate an API key from your dashboard.
-2.  Set it as an environment variable *before* running the MCP server:
-    ```bash
-    export AGENTR_API_KEY="your_api_key_here"
-    ```
-
-**1. Create a Configuration File (e.g., `config.json`)**
-
-This file defines the server settings, credential stores, and the applications to load with their respective integrations.
-
-```python
-{
-  "name": "My Local MCP Server",
-  "description": "A server for testing applications locally",
-  "type": "local",                  # Or "agentr" to load apps dynamically from AgentR
-  "transport": "sse",
-  "port": 8005,
-  "store": {
-    "name": "my_mcp_store",
-    "type": "keyring"
-  },
-  "apps": [
-    {
-      "name": "zenquotes",          # App slug
-      "integration": null           # No authentication needed
-    },
-    {
-      "name": "tavily",
-      "integration": {
-        "name": "TAVILY_API_KEY",   # Unique name for this credential
-        "type": "api_key",
-        "store": {
-          "type": "environment"
-        }
-      }
-    },
-    {
-      "name": "github",
-      "integration": {
-        "name": "github",          # Matches the service name in AgentR
-        "type": "agentr"           # Uses AgentR platform for auth/creds
-      }
-    }
-  ]
-}
-```
-
-*Notes:*
-*   `type: "local"` runs applications defined directly in the config's `apps` list.
-*   `type: "agentr"` connects to the AgentR platform to dynamically load user-enabled apps (ignores the `apps` list in the config) and handle credentials (requires `AGENTR_API_KEY` env var).
-*   `store`: Defines credential storage. `environment` looks for `<INTEGRATION_NAME_UPPERCASE>` env var (e.g., `TAVILY_API_KEY`). `keyring` uses the system's secure storage. `memory` is transient.
-*   `integration`: Configures authentication for each app when using `type: "local"`. `type: "agentr"` uses the AgentR platform for OAuth/credential management. `type: "api_key"` uses the specified `store`.
-
-**2. Run the Server via CLI**
-
-Make sure any required environment variables (like `TAVILY_API_KEY` for the example above, or `AGENTR_API_KEY` if using `"agentr"` type server/integrations) are set.
-
-```bash
-universal_mcp run -c config.json
-```
-
-The server will start, load the configured applications (or connect to AgentR if `type: "agentr"`), and listen for connections based on the `transport` type (`sse`, `stdio`, or `http`).
-
-## 🛠️ Using Playground
-
-The `playground` directory provides a runnable example with a FastAPI backend and a Streamlit frontend for interacting with the MCP server.
-
-**Prerequisites:**
-
-*   Ensure `local_config.json` exists in the project root directory. See `src/playground/README.md` for its format. This configures the *local* MCP server that the playground backend connects to.
-*   Install playground dependencies if needed (e.g., `fastapi`, `streamlit`, `uvicorn`, `langchain`, etc.).
-
-**Running the Playground:**
-
-The easiest way is to use the automated startup script from the **project root directory**:
-
-```bash
-python src/playground
-```
-Refer to `src/playground/README.md` for more detailed setup and usage instructions.
-
-## 🧩 Available Applications
-Visit [https://agentr.dev](https://agentr.dev) to check all available applications
-
-*Authentication Type notes:*
-*   *OAuth (AgentR)*: Typically requires configuring the integration with `type: "agentr"` in your `ServerConfig`. Requires the `AGENTR_API_KEY`.
-*   *API Key (via Integration)*: Requires configuring `type: "api_key"` and a `store` (like `environment` or `keyring`) in your `ServerConfig`.
-
-## 🔐 Integration Types
-
-Universal MCP supports different ways to handle authentication for applications:
-
-### 1. API Key Integration
-
-For services that authenticate via simple API keys. Configure using `IntegrationConfig` with `type: "api_key"`.
-
-```python
-{
-  "name": "tavily",
-  "integration": {
-    "name": "TAVILY_API_KEY",
-    "type": "api_key",
-    "store": {
-      "name": "universal_mcp",
-      "type": "environment"   # Or "keyring", "memory"
-       }
-    } 
-}
-```
-
-### 2. AgentR Integration
-
-For services integrated with the AgentR platform, typically handling OAuth flows or centrally managed credentials. Configure using `IntegrationConfig` with `type: "agentr"`. Requires the `AGENTR_API_KEY` environment variable to be set for the MCP server process.
-
-```python
-{
-  "name": "github",
-  "integration": {
-    "name": "github", # Matches the service name configured in AgentR
-    "type": "agentr"
-  }
-}
-```
-When an action requiring authorization is called, the `AgentRIntegration` will prompt the user (via the MCP client) to visit a URL to complete the OAuth flow managed by AgentR. This is also the default integration type when using `type: "agentr"` for the main server config.
-
-### 3. OAuth Integration (Direct - Less Common)
-
-While `AgentRIntegration` is preferred for OAuth, a direct `OAuthIntegration` class exists but requires manual configuration of client IDs, secrets, and handling callbacks, which is generally more complex to set up outside the AgentR platform.
-
-## 🤖 CLI Usage
-
-Universal MCP includes a command-line interface:
-
-```bash
-# Run the MCP server using a configuration file
-universal_mcp run -c config.json
-
-# Generate API client code and application structure from an OpenAPI schema
-# Output file name (e.g., 'twitter.py') determines app name ('twitter')
-universal_mcp generate --schema <path_to_schema.json/yaml> --output <path/to/output_app_name.py> [--no-docstrings]
-
-# Generate Google-style docstrings for functions in a Python file using an LLM
-universal_mcp docgen <path/to/file.py> [--model <model_name>] [--api-key <llm_api_key>]
-
-# Install MCP configuration for supported desktop apps (Claude, Cursor)
-# Requires AgentR API key for configuration.
-universal_mcp install claude
-universal_mcp install cursor
-
-# Check installed version (standard typer command)
-universal_mcp --version
-```
-
-## 📋 Requirements
-
--   Python 3.11+
--   Dependencies (installed automatically via pip):
-    -   `mcp-server`
-    -   `loguru`
-    -   `typer`
-    -   `httpx`
-    -   `pydantic`
-    -   `pyyaml`
-    -   `keyring` (optional, for `KeyringStore`)
-    -   `litellm` (optional, for `docgen` command)
-    -   ... and others specific to certain applications.
-
-## 📚 Documentation
-
-For more detailed information about specific components:
-
-- [Tools Documentation](src/universal_mcp/tools/README.md) - Learn about tool management and conversion
-- [Servers Documentation](src/universal_mcp/servers/README.md) - Understand different server implementations
-- [Stores Documentation](src/universal_mcp/stores/README.md) - Explore credential storage options
-- [Integrations Documentation](src/universal_mcp/integrations/README.md) - Learn about authentication methods
-
-## 📝 License
-
-This project is licensed under the MIT License.
-

universal_mcp-0.1.15rc5.dist-info/RECORD

@@ -1,39 +0,0 @@
-universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/analytics.py,sha256=aGCg0Okpcy06W70qCA9I8_ySOiCgAtzJAIWAdhBsOeA,2212
-universal_mcp/cli.py,sha256=XujnWHxz5NVxQjwu2BRHUcGC--Vp98M32n8hTsEqayI,8689
-universal_mcp/config.py,sha256=xqz5VNxtk6Clepjw-aK-HrgMFQLzFuxiDb1fuHGpbxE,3717
-universal_mcp/exceptions.py,sha256=WApedvzArNujD0gZfUofYBxjQo97ZDJLqDibtLWZoRk,373
-universal_mcp/logger.py,sha256=JtAC8ImO74lvt5xepV3W5BIz-u3nZOAY1ecdhmQhub0,2081
-universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/applications/__init__.py,sha256=ZjV0P55Ej0vjIQ_bCSNatWTX-VphDJ6OGePWBu3bu3U,3196
-universal_mcp/applications/application.py,sha256=0eC9D4HHRwIGpuFusaCxTZ0u64U68VbBpRSxjxGB5y8,8152
-universal_mcp/integrations/README.md,sha256=lTAPXO2nivcBe1q7JT6PRa6v9Ns_ZersQMIdw-nmwEA,996
-universal_mcp/integrations/__init__.py,sha256=tg6Yk59AEhwPsrTp0hZQ3NBfmJuYGu2sNCOXuph-h9k,922
-universal_mcp/integrations/integration.py,sha256=genBiaWuzCs-XCf3UD1j8PQYyGU3GiVO4uupSdJRHnA,12601
-universal_mcp/servers/README.md,sha256=ytFlgp8-LO0oogMrHkMOp8SvFTwgsKgv7XhBVZGNTbM,2284
-universal_mcp/servers/__init__.py,sha256=etFrqXFODIl9oGeqQS-aUxzw4J6pjzYjHl4VPvQaR3A,508
-universal_mcp/servers/server.py,sha256=0oJQQUiwPdG2q79tzsVv3WPMV5YIFbF14PRvBF-SxMQ,9395
-universal_mcp/stores/README.md,sha256=jrPh_ow4ESH4BDGaSafilhOVaN8oQ9IFlFW-j5Z5hLA,2465
-universal_mcp/stores/__init__.py,sha256=quvuwhZnpiSLuojf0NfmBx2xpaCulv3fbKtKaSCEmuM,603
-universal_mcp/stores/store.py,sha256=lYaFd-9YKC404BPeqzNw_Xm3ziQjksZyvQtaW1yd9FM,6900
-universal_mcp/templates/README.md.j2,sha256=Mrm181YX-o_-WEfKs01Bi2RJy43rBiq2j6fTtbWgbTA,401
-universal_mcp/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
-universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
-universal_mcp/tools/__init__.py,sha256=GgK8CAxskkoif4WCaXsjs4zTgqN9VcVMyQa2G2LaYJ4,92
-universal_mcp/tools/adapters.py,sha256=oCF042vsOKP9bUT6000YbYEmOpOiroXEnMdDMs847CU,1235
-universal_mcp/tools/func_metadata.py,sha256=bxcwwKkHcITZQXt1eal7rFr5NGCrC0SLSGZwOsyCVKo,7985
-universal_mcp/tools/manager.py,sha256=Ne37cLlyk0oku0iUXbc6BmzNH-3a98oWcpe_nlyZRtU,7516
-universal_mcp/tools/tools.py,sha256=2ddZdi618xTs36iM062Pc6cnIbVP17L4NRBMNiFuv1k,3306
-universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
-universal_mcp/utils/agentr.py,sha256=3sobve7Odk8pIAZm3RHTX4Rc21rkBClcXQgXXslbSUA,3490
-universal_mcp/utils/api_generator.py,sha256=x3LkJm3tXgl2qVQq-ZQW86w7IqbErEdFTfwBP3aOwyI,4763
-universal_mcp/utils/docgen.py,sha256=zPmZ-b-fK6xk-dwHEx2hwShN-iquPD_O15CGuPwlj2k,21870
-universal_mcp/utils/docstring_parser.py,sha256=j7aE-LLnBOPTJI0qXayf0NlYappzxICv5E_hUPNmAlc,11459
-universal_mcp/utils/installation.py,sha256=1n5X_aIiuY8WNQn6Oji_gZ-aiRmNXxrg-qYRv-pGjxw,10195
-universal_mcp/utils/openapi.py,sha256=fd4rfiT_hFmEHtzGg-tM3FMSAn-AT0EskKfOc71--jE,23317
-universal_mcp/utils/readme.py,sha256=Q4E3RidWVg0ngYBGZCKcoA4eX6wlkCpvU-clU0E7Q20,3305
-universal_mcp/utils/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
-universal_mcp-0.1.15rc5.dist-info/METADATA,sha256=OXwhLXpEIbkAsrFWmwx6aO_nhtHjjhif2yN-2kthT_M,9833
-universal_mcp-0.1.15rc5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp-0.1.15rc5.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
-universal_mcp-0.1.15rc5.dist-info/RECORD,,