universal-mcp 0.1.7rc1__py3-none-any.whl → 0.1.8__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 (61) hide show
  1. universal_mcp/__init__.py +0 -2
  2. universal_mcp/analytics.py +75 -0
  3. universal_mcp/applications/ahrefs/README.md +76 -0
  4. universal_mcp/applications/ahrefs/app.py +2291 -0
  5. universal_mcp/applications/application.py +95 -5
  6. universal_mcp/applications/calendly/README.md +78 -0
  7. universal_mcp/applications/calendly/__init__.py +0 -0
  8. universal_mcp/applications/calendly/app.py +1195 -0
  9. universal_mcp/applications/coda/README.md +133 -0
  10. universal_mcp/applications/coda/__init__.py +0 -0
  11. universal_mcp/applications/coda/app.py +3671 -0
  12. universal_mcp/applications/e2b/app.py +14 -28
  13. universal_mcp/applications/figma/README.md +74 -0
  14. universal_mcp/applications/figma/__init__.py +0 -0
  15. universal_mcp/applications/figma/app.py +1261 -0
  16. universal_mcp/applications/firecrawl/app.py +38 -35
  17. universal_mcp/applications/github/app.py +127 -85
  18. universal_mcp/applications/google_calendar/app.py +62 -138
  19. universal_mcp/applications/google_docs/app.py +47 -52
  20. universal_mcp/applications/google_drive/app.py +119 -113
  21. universal_mcp/applications/google_mail/app.py +124 -50
  22. universal_mcp/applications/google_sheet/app.py +89 -91
  23. universal_mcp/applications/markitdown/app.py +9 -8
  24. universal_mcp/applications/notion/app.py +254 -134
  25. universal_mcp/applications/perplexity/app.py +13 -41
  26. universal_mcp/applications/reddit/app.py +94 -85
  27. universal_mcp/applications/resend/app.py +12 -13
  28. universal_mcp/applications/{serp → serpapi}/app.py +14 -25
  29. universal_mcp/applications/tavily/app.py +11 -18
  30. universal_mcp/applications/wrike/README.md +71 -0
  31. universal_mcp/applications/wrike/__init__.py +0 -0
  32. universal_mcp/applications/wrike/app.py +1372 -0
  33. universal_mcp/applications/youtube/README.md +82 -0
  34. universal_mcp/applications/youtube/__init__.py +0 -0
  35. universal_mcp/applications/youtube/app.py +1428 -0
  36. universal_mcp/applications/zenquotes/app.py +12 -2
  37. universal_mcp/exceptions.py +9 -2
  38. universal_mcp/integrations/__init__.py +24 -1
  39. universal_mcp/integrations/agentr.py +27 -4
  40. universal_mcp/integrations/integration.py +146 -32
  41. universal_mcp/logger.py +3 -56
  42. universal_mcp/servers/__init__.py +6 -14
  43. universal_mcp/servers/server.py +201 -146
  44. universal_mcp/stores/__init__.py +7 -2
  45. universal_mcp/stores/store.py +103 -40
  46. universal_mcp/tools/__init__.py +3 -0
  47. universal_mcp/tools/adapters.py +43 -0
  48. universal_mcp/tools/func_metadata.py +213 -0
  49. universal_mcp/tools/tools.py +342 -0
  50. universal_mcp/utils/docgen.py +325 -119
  51. universal_mcp/utils/docstring_parser.py +179 -0
  52. universal_mcp/utils/dump_app_tools.py +33 -23
  53. universal_mcp/utils/installation.py +201 -10
  54. universal_mcp/utils/openapi.py +229 -46
  55. {universal_mcp-0.1.7rc1.dist-info → universal_mcp-0.1.8.dist-info}/METADATA +9 -5
  56. universal_mcp-0.1.8.dist-info/RECORD +81 -0
  57. universal_mcp-0.1.7rc1.dist-info/RECORD +0 -58
  58. /universal_mcp/{utils/bridge.py → applications/ahrefs/__init__.py} +0 -0
  59. /universal_mcp/applications/{serp → serpapi}/README.md +0 -0
  60. {universal_mcp-0.1.7rc1.dist-info → universal_mcp-0.1.8.dist-info}/WHEEL +0 -0
  61. {universal_mcp-0.1.7rc1.dist-info → universal_mcp-0.1.8.dist-info}/entry_points.txt +0 -0
@@ -1,6 +1,7 @@
1
- from e2b_code_interpreter import Sandbox
2
- from loguru import logger
3
1
  from typing import Annotated
2
+
3
+ from e2b_code_interpreter import Sandbox
4
+
4
5
  from universal_mcp.applications.application import APIApplication
5
6
  from universal_mcp.integrations import Integration
6
7
 
@@ -13,24 +14,6 @@ class E2BApp(APIApplication):
13
14
 
14
15
  def __init__(self, integration: Integration | None = None) -> None:
15
16
  super().__init__(name="e2b", integration=integration)
16
- self.api_key: str | None = None
17
-
18
- def _set_api_key(self):
19
- if self.api_key:
20
- return
21
-
22
- if not self.integration:
23
- raise ValueError("Integration is None. Cannot retrieve E2B API Key.")
24
-
25
- credentials = self.integration.get_credentials()
26
- if not credentials:
27
- raise ValueError(
28
- f"Failed to retrieve E2B API Key using integration '{self.integration.name}'. "
29
- f"Check store configuration (e.g., ensure the correct environment variable is set)."
30
- )
31
-
32
- self.api_key = credentials
33
- logger.info("E2B API Key successfully retrieved via integration.")
34
17
 
35
18
  def _format_execution_output(self, logs) -> str:
36
19
  """Helper function to format the E2B execution logs nicely."""
@@ -54,21 +37,24 @@ class E2BApp(APIApplication):
54
37
  self, code: Annotated[str, "The Python code to execute."]
55
38
  ) -> str:
56
39
  """
57
- Executes Python code within a secure E2B cloud sandbox.
40
+ Executes Python code in a sandbox environment and returns the formatted output
58
41
 
59
42
  Args:
60
- code: The string containing the Python code to execute.
43
+ code: String containing the Python code to be executed in the sandbox
61
44
 
62
45
  Returns:
63
- A string containing the formatted standard output (stdout) and standard error (stderr)
64
- from the execution. If an error occurs during setup or execution, an
65
- error message string is returned.
46
+ A string containing the formatted execution output/logs from running the code
66
47
 
67
48
  Raises:
68
- NotAuthorizedError: If the API key is not set.
49
+ SandboxError: When there are issues with sandbox initialization or code execution
50
+ AuthenticationError: When API key authentication fails during sandbox setup
51
+ ValueError: When provided code string is empty or invalid
52
+
53
+ Tags:
54
+ execute, sandbox, code-execution, security, important
69
55
  """
70
- self._set_api_key()
71
- with Sandbox(api_key=self.api_key) as sandbox:
56
+ api_key = self.integration.get_credentials().get("api_key")
57
+ with Sandbox(api_key=api_key) as sandbox:
72
58
  execution = sandbox.run_code(code=code)
73
59
  result = self._format_execution_output(execution.logs)
74
60
  return result
@@ -0,0 +1,74 @@
1
+
2
+ # Figma MCP Server
3
+
4
+ An MCP Server for the Figma API.
5
+
6
+ ## Supported Integrations
7
+
8
+ - AgentR
9
+ - API Key (Coming Soon)
10
+ - OAuth (Coming Soon)
11
+
12
+ ## Tools
13
+
14
+ This is automatically generated from OpenAPI schema for the Figma API.
15
+
16
+ ## Supported Integrations
17
+
18
+ This tool can be integrated with any service that supports HTTP requests.
19
+
20
+ ## Tool List
21
+
22
+ | Tool | Description |
23
+ |------|-------------|
24
+ | get_file | Retrieves file metadata and content from the API using the specified file key and optional query parameters. |
25
+ | get_file_nodes | Fetches node data for specified IDs from a file, supporting optional filters such as version, depth, geometry, and plugin data. |
26
+ | get_images | Retrieves image assets from a remote service for specified node IDs within a given file, with optional image format and export options. |
27
+ | get_image_fills | Retrieves image fill data for a given file key from the API. |
28
+ | get_team_projects | Retrieves the list of projects associated with a specified team. |
29
+ | get_project_files | Retrieves the list of files associated with a specified project, optionally filtered by branch data. |
30
+ | get_file_versions | Retrieves a paginated list of version history for a specified file. |
31
+ | get_comments | Retrieves comments for a specified file, optionally formatting the output as Markdown. |
32
+ | post_comment | Posts a comment to a specified file. |
33
+ | delete_comment | Deletes a specific comment from a file identified by its key and comment ID. |
34
+ | get_comment_reactions | Retrieves the reactions associated with a specific comment in a file. |
35
+ | post_comment_reaction | Posts a reaction emoji to a specific comment on a file. |
36
+ | delete_comment_reaction | Removes a specific emoji reaction from a comment in a file. |
37
+ | get_me | Retrieves information about the authenticated user from the API. |
38
+ | get_team_components | Retrieves a paginated list of components associated with a specified team. |
39
+ | get_file_components | Retrieves the component information for a specified file from the API. |
40
+ | get_component | Retrieves a component's details by its key from the API. |
41
+ | get_team_component_sets | Retrieves a paginated list of component sets for a specified team. |
42
+ | get_file_component_sets | Retrieves the list of component sets associated with a specific file key. |
43
+ | get_component_set | Retrieves a component set resource by its key from the server. |
44
+ | get_team_styles | Retrieves a list of styles for a specified team, with optional pagination controls. |
45
+ | get_file_styles | Retrieves the style definitions for a specified file from the API. |
46
+ | get_style | Retrieves a style resource identified by the given key from the API. |
47
+ | post_webhook | Registers a new webhook for a specified event type and team. |
48
+ | get_webhook | Retrieves the details of a specific webhook by its unique identifier. |
49
+ | put_webhook | Update an existing webhook's configuration with new settings such as event type, endpoint, passcode, status, or description. |
50
+ | delete_webhook | Deletes a webhook with the specified webhook ID. |
51
+ | get_team_webhooks | Retrieves the list of webhooks configured for a given team. |
52
+ | get_webhook_requests | Retrieves the list of requests for a specified webhook. |
53
+ | get_activity_logs | Retrieves activity logs from the API with optional filters for events, time range, limit, and order. |
54
+ | get_payments | Retrieves a list of payments based on the provided filter criteria. |
55
+ | get_local_variables | Retrieves the local variables associated with a specific file identified by file_key. |
56
+ | get_published_variables | Retrieves the published variables associated with a specified file key from the server. |
57
+ | post_variables | Posts or updates variable data for a specified file by sending a POST request to the variables endpoint. |
58
+ | get_dev_resources | Retrieves development resources for a specific file. |
59
+ | post_dev_resources | Submits developer resources to the API and returns the parsed JSON response. |
60
+ | put_dev_resources | Updates the development resources by sending a PUT request to the dev_resources endpoint. |
61
+ | delete_dev_resource | Deletes a specific development resource associated with a file. |
62
+
63
+
64
+
65
+ ## Usage
66
+
67
+ - Login to AgentR
68
+ - Follow the quickstart guide to setup MCP Server for your client
69
+ - Visit Apps Store and enable the Figma app
70
+ - Restart the MCP Server
71
+
72
+ ### Local Development
73
+
74
+ - Follow the README to test with the local MCP Server
File without changes