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

universal_mcp-0.1.16.dist-info/METADATA

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: universal-mcp
+Version: 0.1.16
+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
+License-File: LICENSE
+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: langchain-mcp-adapters>=0.0.3
+Requires-Dist: litellm>=1.30.7
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: mcp>=1.7.1
+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-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: litellm>=1.30.7; 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 Control Protocol (MCP). It simplifies credential management, authorization, dynamic app enablement, and provides a robust framework for building and managing AI-powered tools.
+
+## 🌟 Features
+
+- **MCP (Model Control Protocol) Integration**: Seamlessly works with MCP server architecture for standardized agent-tool communication.
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code. See [AgentR](https://agentr.dev) for a list of available applications.
+- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows, often managed via the AgentR platform.
+- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate using provided base classes and generation tools.
+- **Credential Management**: Flexible and secure storage options for API credentials (memory, environment variables, system keyring).
+- **Comprehensive Tool Management**: Robust tool registration, Pydantic-based validation, automatic docstring parsing, and execution capabilities. Supports conversion between MCP, LangChain, and OpenAI tool formats.
+- **Multiple Server Types**: Configurations for local development, AgentR-connected dynamic app loading, and single-application servers.
+- **Playground Environment**: Includes an interactive Streamlit-based playground for testing agents and tools.
+
+## 🔧 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 MCP server itself 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.
+
+```json
+{
+  "name": "My Local MCP Server",
+  "description": "A server for testing applications locally",
+  "type": "local", // "local" or "agentr"
+  "transport": "sse", // "sse", "stdio", or "http"
+  "port": 8005, // Relevant for "sse" or "http"
+  "store": {
+    // Default store for integrations
+    "name": "my_mcp_store",
+    "type": "keyring" // "keyring", "environment", or "memory"
+  },
+  "apps": [
+    {
+      "name": "zenquotes", // App slug (e.g., from agentr.dev)
+      "integration": null // No authentication needed for this app
+    },
+    {
+      "name": "tavily",
+      "integration": {
+        "name": "TAVILY_API_KEY", // Unique name for this credential if type is "api_key"
+        "type": "api_key",
+        "store": {
+          // Override default store for this specific app
+          "type": "environment" // Looks for TAVILY_API_KEY env var
+        }
+      }
+    },
+    {
+      "name": "github",
+      "integration": {
+        "name": "github", // Matches the service name in AgentR
+        "type": "agentr" // Uses AgentR platform for auth/creds
+      }
+    }
+  ]
+}
+```
+
+_Notes on `config.json`:_
+
+- `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` environment variable.
+- `store`: Defines credential storage.
+  - `environment`: Looks for an environment variable named `<INTEGRATION_NAME_UPPERCASE>` (e.g., `TAVILY_API_KEY` for the example above).
+  - `keyring`: Uses the system's secure credential storage.
+  - `memory`: Transient storage, lost when the server stops.
+- `integration`: Configures authentication for each app.
+  - `type: "agentr"`: Uses the AgentR platform for OAuth/credential management.
+  - `type: "api_key"`: Uses the specified `store` to retrieve the key.
+
+**2. Run the Server via CLI**
+
+Ensure any required environment variables (like `TAVILY_API_KEY` for the Tavily example, 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.
+
+## 🛠️ Using the Playground
+
+The `playground` directory provides a runnable Streamlit application for interacting with agents that can use tools from an MCP server.
+
+**Prerequisites:**
+
+- **`local_config.json`**: This file must exist in the **project root directory** (the same directory as this `README.md`). It configures the _local_ MCP server that the playground's agent can connect to if you choose to run one. For an example, see the `local_config.json` structure in the [Playground README](playground/README.md).
+- **Dependencies**: Install playground-specific dependencies. If you have the project cloned, you might install them via:
+  ```bash
+  pip install -e .[playground]
+  # or manually install fastapi, streamlit, uvicorn, langchain-openai, etc.
+  ```
+
+**Running the Playground:**
+
+The easiest way is to use the automated startup script from the **project root directory**:
+
+```bash
+python playground
+```
+
+This script will:
+
+1. Optionally start a local MCP server (based on your `local_config.json`) if you confirm.
+2. Launch the Streamlit application.
+
+For more detailed setup, manual startup instructions, and an explanation of the `local_config.json` for the playground, please refer to the [Playground README](playground/README.md).
+
+## 🧩 Available Applications
+
+Universal MCP can integrate with a wide variety of applications. For a list of publicly available applications and their slugs (e.g., "github", "google-calendar"), please visit [AgentR Applications](https://agentr.dev).
+Applications are typically installed dynamically by Universal MCP from their respective repositories when first referenced by slug.
+
+_Authentication Type Notes:_
+
+- _OAuth (via AgentR)_: Usually requires configuring the app's integration with `type: "agentr"` in your `ServerConfig`. This leverages the AgentR platform for the OAuth flow and requires the `AGENTR_API_KEY` to be set.
+- _API Key (via Integration)_: Requires configuring `type: "api_key"` for the app's integration in your `ServerConfig`, along with a `store` (like `environment` or `keyring`) to specify where the API key is located.
+
+## 🔐 Integration Types
+
+Universal MCP supports different ways to handle authentication for applications:
+
+### 1. API Key Integration (`type: "api_key"`)
+
+For services that authenticate via simple API keys.
+
+```json
+// In your ServerConfig apps array:
+{
+  "name": "tavily",
+  "integration": {
+    "name": "TAVILY_API_KEY", // Used by the store (e.g., as env var name)
+    "type": "api_key",
+    "store": {
+      "type": "environment" // Or "keyring", "memory"
+    }
+  }
+}
+```
+
+### 2. AgentR Integration (`type: "agentr"`)
+
+Recommended for services integrated with the AgentR platform, which typically handles OAuth flows or centrally managed credentials. Requires the `AGENTR_API_KEY` environment variable to be set for the MCP server process.
+
+```json
+// In your ServerConfig apps array:
+{
+  "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 for apps if the main server config is `type: "agentr"`.
+
+### 3. Direct OAuth Integration (`type: "oauth"`)
+
+While `AgentRIntegration` is generally preferred for OAuth, a direct `OAuthIntegration` class exists. However, it requires manual configuration of client IDs, secrets, and callback handling, which is more complex to set up outside the AgentR platform.
+
+## 🤖 CLI Usage
+
+Universal MCP includes a powerful command-line interface:
+
+```bash
+# Run the MCP server using a configuration file
+universal_mcp run -c config.json
+
+# Initialize a new MCP application project structure
+universal_mcp init --app-name my-cool-app --o ./my-apps --integration-type api_key
+
+# Generate API client code and application structure from an OpenAPI schema
+universal_mcp generate -s <path_to_schema.json_or_yaml> -o <path/to/app_output_directory> --c CustomAppClassName
+# Example: universal_mcp generate -s notion_api.yaml -o ./custom_apps/notion --c MyNotionApp
+
+# Preprocess an OpenAPI schema using an LLM to fill/enhance descriptions
+universal_mcp preprocess -s <path_to_input_schema.json_or_yaml> -o <path_to_processed_schema.json_or_yaml>
+
+# Generate Google-style docstrings for functions in a Python file using an LLM
+universal_mcp docgen <path/to/app_file.py>
+
+# Generate a README.md for a generated application file
+universal_mcp readme <path/to/app_file.py>
+
+# Install MCP configuration for supported desktop apps (e.g., Claude, Cursor)
+# Requires an 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.10+
+- Key Dependencies (installed automatically via pip, see `pyproject.toml` for full list):
+  - `mcp-server`
+  - `loguru`
+  - `typer`
+  - `httpx`
+  - `pydantic`
+  - `pyyaml`
+  - `keyring` (for `KeyringStore`)
+  - `litellm` (for `docgen` and `preprocess` commands)
+  - `uv` (used internally for dynamic package installation)
+
+## 📚 Documentation
+
+For more detailed information about specific components:
+
+- [Applications Framework](src/universal_mcp/applications/README.md)
+- [Tool Management](src/universal_mcp/tools/README.md)
+- [Server Implementations](src/universal_mcp/servers/README.md)
+- [Credential Stores](src/universal_mcp/stores/README.md)
+- [Integration & Authentication](src/universal_mcp/integrations/README.md)
+- [Playground Usage](playground/README.md)
+
+## 📝 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

universal_mcp-0.1.16.dist-info/RECORD

@@ -0,0 +1,44 @@
+universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/analytics.py,sha256=Dkv8mkc_2T2t5NxLSZzcr3BlmOispj1RKtbB86V1i4M,2306
+universal_mcp/cli.py,sha256=MkWxF2uawR-6rHX5TepPavgXgWVedg5LmL0ioz16nUI,8399
+universal_mcp/config.py,sha256=UgonQUVQ_qRXWGmfSr1s9gDBpxcgTY3ZQyo1g4B47-o,3477
+universal_mcp/exceptions.py,sha256=2A_aIzcwjB99tR4xCFjPkWPf10rBK_785FerJI7Tzns,564
+universal_mcp/logger.py,sha256=VmH_83efpErLEDTJqz55Dp0dioTXfGvMBLZUx5smOLc,2116
+universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/applications/README.md,sha256=eqbizxaTxKH2O1tyIJR2yI0Db5TQxtgPd_vbpWyCa2Y,3527
+universal_mcp/applications/__init__.py,sha256=yDLrQhICcvoSf8KTLkKOdqcG1N7c4UOYL3tNIjAo2kk,3182
+universal_mcp/applications/application.py,sha256=3P7dpdOukaXnubjQi8jV_NZYESpW8QWYLF6QdcxzxzA,13771
+universal_mcp/integrations/README.md,sha256=lTAPXO2nivcBe1q7JT6PRa6v9Ns_ZersQMIdw-nmwEA,996
+universal_mcp/integrations/__init__.py,sha256=zEHYH_1FBsWvHssOMkaElQXG5UydciZfoTS49Q_Um6E,916
+universal_mcp/integrations/integration.py,sha256=4SRcD78ZF9-m65aTxkoF-CZl7XKUsfSr1wppKz_ZgiA,13078
+universal_mcp/servers/README.md,sha256=ytFlgp8-LO0oogMrHkMOp8SvFTwgsKgv7XhBVZGNTbM,2284
+universal_mcp/servers/__init__.py,sha256=etFrqXFODIl9oGeqQS-aUxzw4J6pjzYjHl4VPvQaR3A,508
+universal_mcp/servers/server.py,sha256=1UWvywUzgGVYyIGlaES9tgj_xP_f6EC4bK_vM0nE_tE,9237
+universal_mcp/stores/README.md,sha256=jrPh_ow4ESH4BDGaSafilhOVaN8oQ9IFlFW-j5Z5hLA,2465
+universal_mcp/stores/__init__.py,sha256=quvuwhZnpiSLuojf0NfmBx2xpaCulv3fbKtKaSCEmuM,603
+universal_mcp/stores/store.py,sha256=mxnmOVlDNrr8OKhENWDtCIfK7YeCBQcGdS6I2ogRCsU,6756
+universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
+universal_mcp/tools/__init__.py,sha256=Fatza_R0qYWmNF1WQSfUZZKQFu5qf-16JhZzdmyx3KY,333
+universal_mcp/tools/adapters.py,sha256=gz_sNDc_bseMHWmpQmqhOq65veE-DuK_kJYXGIx0Wi8,1427
+universal_mcp/tools/func_metadata.py,sha256=zIDXgIBvu5Gh8aNlg-Q7cZZos9Iky75MS0Me0BraXeM,8086
+universal_mcp/tools/manager.py,sha256=Uqa6aEGAVcZC_Q69L8KQQiW4D_cXvrJQL1lg3_L7GuQ,7526
+universal_mcp/tools/tools.py,sha256=8YBTaJCM38Nhan9Al6Vlq4FtSULrKlxg1q_o8OL1_FM,3322
+universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
+universal_mcp/utils/agentr.py,sha256=GlFK5_RJXP3XpIGKLzkIe5nu2rfT6bqSoT0h1hipy9g,3438
+universal_mcp/utils/common.py,sha256=HEZC2Mhilb8DrGXQG2tboAIw1r4veGilGWjfnPF1lyA,888
+universal_mcp/utils/docstring_parser.py,sha256=6oIeCjOUirFdVpXdGZt5zDKje6jmCY42-GeYOc_7r2I,11317
+universal_mcp/utils/installation.py,sha256=lj7_2je7qbXe2tL0JyD3SyNvCSuANLFABaZynwjCGqk,7283
+universal_mcp/utils/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
+universal_mcp/utils/openapi/__inti__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+universal_mcp/utils/openapi/api_generator.py,sha256=FjtvbnWuI1P8W8wXuKLCirUtsqQ4HI_TuQrhpA4SqTs,4749
+universal_mcp/utils/openapi/docgen.py,sha256=DNmwlhg_-TRrHa74epyErMTRjV2nutfCQ7seb_Rq5hE,21366
+universal_mcp/utils/openapi/openapi.py,sha256=r2Kuccn8acawCWjSSzvem_rFmiIVr1sHgU_O03W8q30,36594
+universal_mcp/utils/openapi/preprocessor.py,sha256=qLYv4ekors5B2OU_YUvXICYQ7XYhAOEPyAnKtnBvNpM,46699
+universal_mcp/utils/openapi/readme.py,sha256=R2Jp7DUXYNsXPDV6eFTkLiy7MXbSULUj1vHh4O_nB4c,2974
+universal_mcp/utils/templates/README.md.j2,sha256=Mrm181YX-o_-WEfKs01Bi2RJy43rBiq2j6fTtbWgbTA,401
+universal_mcp/utils/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
+universal_mcp-0.1.16.dist-info/METADATA,sha256=IR1TbIkUM2NxYhZEAQIYvnr2qungmK-DT94mVB15wyY,12122
+universal_mcp-0.1.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+universal_mcp-0.1.16.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
+universal_mcp-0.1.16.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
+universal_mcp-0.1.16.dist-info/RECORD,,

universal_mcp-0.1.15rc7.dist-info/METADATA

@@ -1,247 +0,0 @@
-Metadata-Version: 2.4
-Name: universal-mcp
-Version: 0.1.15rc7
-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
-License-File: LICENSE
-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: langchain-mcp-adapters>=0.0.3
-Requires-Dist: litellm>=1.30.7
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.7.1
-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-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: litellm>=1.30.7; 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.15rc7.dist-info/RECORD

@@ -1,44 +0,0 @@
-universal_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/analytics.py,sha256=Dkv8mkc_2T2t5NxLSZzcr3BlmOispj1RKtbB86V1i4M,2306
-universal_mcp/cli.py,sha256=fqB4CzcA2CAg1m4tzhK0k9X4otHWxaAy2edP1QQYUIQ,8974
-universal_mcp/config.py,sha256=xqz5VNxtk6Clepjw-aK-HrgMFQLzFuxiDb1fuHGpbxE,3717
-universal_mcp/exceptions.py,sha256=2A_aIzcwjB99tR4xCFjPkWPf10rBK_785FerJI7Tzns,564
-universal_mcp/logger.py,sha256=JtAC8ImO74lvt5xepV3W5BIz-u3nZOAY1ecdhmQhub0,2081
-universal_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/applications/README.md,sha256=eqbizxaTxKH2O1tyIJR2yI0Db5TQxtgPd_vbpWyCa2Y,3527
-universal_mcp/applications/__init__.py,sha256=zyV_0GyunGBA5OEO1FQsTOsj34SYjnERu5dDJLxd6c0,3133
-universal_mcp/applications/application.py,sha256=9PfmvVx1csmy0RzaTC71S4DkMD8VxvY3yIsMAt3dQLw,14425
-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=4SRcD78ZF9-m65aTxkoF-CZl7XKUsfSr1wppKz_ZgiA,13078
-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=mxnmOVlDNrr8OKhENWDtCIfK7YeCBQcGdS6I2ogRCsU,6756
-universal_mcp/tools/README.md,sha256=RuxliOFqV1ZEyeBdj3m8UKfkxAsfrxXh-b6V4ZGAk8I,2468
-universal_mcp/tools/__init__.py,sha256=Fatza_R0qYWmNF1WQSfUZZKQFu5qf-16JhZzdmyx3KY,333
-universal_mcp/tools/adapters.py,sha256=gz_sNDc_bseMHWmpQmqhOq65veE-DuK_kJYXGIx0Wi8,1427
-universal_mcp/tools/func_metadata.py,sha256=4LrOeQ81RnfWjPp9N-tOkw-nr6XosRw6P0EUriNhpu4,8328
-universal_mcp/tools/manager.py,sha256=OArAbckBay5Lbpu2-oI38zEEbJyM8E_WLB8985B6a70,7718
-universal_mcp/tools/tools.py,sha256=lg1rM9644OLAmi-yXar-olPCAfsu1ol2Aw9XRuIN7Fk,3383
-universal_mcp/utils/__init__.py,sha256=8wi4PGWu-SrFjNJ8U7fr2iFJ1ktqlDmSKj1xYd7KSDc,41
-universal_mcp/utils/agentr.py,sha256=3sobve7Odk8pIAZm3RHTX4Rc21rkBClcXQgXXslbSUA,3490
-universal_mcp/utils/common.py,sha256=F2Teso1Cs4E1dgMq0ESLJOWJ0n9arLX-YuawfYfZg3I,911
-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/singleton.py,sha256=kolHnbS9yd5C7z-tzaUAD16GgI-thqJXysNi3sZM4No,733
-universal_mcp/utils/openapi/__inti__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-universal_mcp/utils/openapi/api_generator.py,sha256=aNzrcglYXL6mQizFQUuiFFKTPuEPgTC1unr6NT_U0VM,4771
-universal_mcp/utils/openapi/docgen.py,sha256=zPmZ-b-fK6xk-dwHEx2hwShN-iquPD_O15CGuPwlj2k,21870
-universal_mcp/utils/openapi/openapi.py,sha256=PeCj01skdvBaYvGedSShgUrzZ2GhEpPX8IOyTvq-ubk,37284
-universal_mcp/utils/openapi/preprocessor.py,sha256=zMCsHv9lNIrIlAMyF39cIm0-c2vydrtbtQjJ0rjcLL8,48765
-universal_mcp/utils/openapi/readme.py,sha256=wTg2D0sPKppPmGn7b-vtD5hAGRv8DLEAuxMNzqBeuEs,3032
-universal_mcp/utils/templates/README.md.j2,sha256=Mrm181YX-o_-WEfKs01Bi2RJy43rBiq2j6fTtbWgbTA,401
-universal_mcp/utils/templates/api_client.py.j2,sha256=972Im7LNUAq3yZTfwDcgivnb-b8u6_JLKWXwoIwXXXQ,908
-universal_mcp-0.1.15rc7.dist-info/METADATA,sha256=Ij-KJ9juKlrmOEiRiJkUK6_rAye0RYrXxjbTZWAz3_w,9886
-universal_mcp-0.1.15rc7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-universal_mcp-0.1.15rc7.dist-info/entry_points.txt,sha256=QlBrVKmA2jIM0q-C-3TQMNJTTWOsOFQvgedBq2rZTS8,56
-universal_mcp-0.1.15rc7.dist-info/licenses/LICENSE,sha256=NweDZVPslBAZFzlgByF158b85GR0f5_tLQgq1NS48To,1063
-universal_mcp-0.1.15rc7.dist-info/RECORD,,