agentr 0.1.6__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.
- agentr/__init__.py +1 -1
- agentr/application.py +93 -56
- agentr/applications/__init__.py +27 -0
- agentr/applications/github/app.py +319 -56
- agentr/applications/google_calendar/app.py +489 -74
- agentr/applications/google_mail/app.py +565 -68
- agentr/applications/reddit/app.py +309 -29
- agentr/applications/resend/app.py +43 -43
- agentr/applications/tavily/app.py +57 -57
- agentr/applications/zenquotes/app.py +20 -20
- agentr/cli.py +76 -75
- agentr/config.py +15 -0
- agentr/exceptions.py +6 -5
- agentr/integration.py +161 -98
- agentr/integrations/README.md +25 -0
- agentr/integrations/__init__.py +5 -0
- agentr/integrations/agentr.py +87 -0
- agentr/integrations/api_key.py +16 -0
- agentr/integrations/base.py +60 -0
- agentr/server.py +128 -105
- agentr/store.py +70 -70
- agentr/test.py +14 -37
- agentr/utils/openapi.py +273 -184
- {agentr-0.1.6.dist-info → agentr-0.1.8.dist-info}/METADATA +4 -1
- agentr-0.1.8.dist-info/RECORD +30 -0
- {agentr-0.1.6.dist-info → agentr-0.1.8.dist-info}/licenses/LICENSE +21 -21
- agentr-0.1.6.dist-info/RECORD +0 -23
- {agentr-0.1.6.dist-info → agentr-0.1.8.dist-info}/WHEEL +0 -0
- {agentr-0.1.6.dist-info → agentr-0.1.8.dist-info}/entry_points.txt +0 -0
agentr/server.py
CHANGED
@@ -1,105 +1,128 @@
|
|
1
|
-
from abc import ABC, abstractmethod
|
2
|
-
|
3
|
-
from mcp.server.fastmcp import FastMCP
|
4
|
-
from agentr.
|
5
|
-
from agentr.
|
6
|
-
from
|
7
|
-
from
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
def
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
return
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
1
|
+
from abc import ABC, abstractmethod
|
2
|
+
import httpx
|
3
|
+
from mcp.server.fastmcp import FastMCP
|
4
|
+
from agentr.applications import app_from_name
|
5
|
+
from agentr.exceptions import NotAuthorizedError
|
6
|
+
from agentr.integration import AgentRIntegration, ApiKeyIntegration
|
7
|
+
from agentr.store import EnvironmentStore, MemoryStore
|
8
|
+
from agentr.config import AppConfig, IntegrationConfig, StoreConfig
|
9
|
+
from loguru import logger
|
10
|
+
import os
|
11
|
+
from typing import Any
|
12
|
+
from mcp.types import TextContent
|
13
|
+
from mcp.server.fastmcp.exceptions import ToolError
|
14
|
+
|
15
|
+
class Server(FastMCP, ABC):
|
16
|
+
"""
|
17
|
+
Server is responsible for managing the applications and the store
|
18
|
+
It also acts as a router for the applications, and exposed to the client
|
19
|
+
|
20
|
+
"""
|
21
|
+
def __init__(self, name: str, description: str, **kwargs):
|
22
|
+
super().__init__(name, description, **kwargs)
|
23
|
+
|
24
|
+
@abstractmethod
|
25
|
+
def _load_apps(self):
|
26
|
+
pass
|
27
|
+
|
28
|
+
async def call_tool(self, name: str, arguments: dict[str, Any]):
|
29
|
+
"""Call a tool by name with arguments."""
|
30
|
+
try:
|
31
|
+
result = await super().call_tool(name, arguments)
|
32
|
+
return result
|
33
|
+
except ToolError as e:
|
34
|
+
raised_error = e.__cause__
|
35
|
+
if isinstance(raised_error, NotAuthorizedError):
|
36
|
+
return [TextContent(type="text", text=raised_error.message)]
|
37
|
+
else:
|
38
|
+
raise e
|
39
|
+
|
40
|
+
class LocalServer(Server):
|
41
|
+
"""
|
42
|
+
Local server for development purposes
|
43
|
+
"""
|
44
|
+
def __init__(self, name: str, description: str, apps_list: list[AppConfig] = [], **kwargs):
|
45
|
+
super().__init__(name, description=description, **kwargs)
|
46
|
+
self.apps_list = [AppConfig.model_validate(app) for app in apps_list]
|
47
|
+
self._load_apps()
|
48
|
+
|
49
|
+
def _get_store(self, store_config: StoreConfig):
|
50
|
+
if store_config.type == "memory":
|
51
|
+
return MemoryStore()
|
52
|
+
elif store_config.type == "environment":
|
53
|
+
return EnvironmentStore()
|
54
|
+
return None
|
55
|
+
|
56
|
+
def _get_integration(self, integration_config: IntegrationConfig):
|
57
|
+
if not integration_config:
|
58
|
+
return None
|
59
|
+
if integration_config.type == "api_key":
|
60
|
+
store = self._get_store(integration_config.store)
|
61
|
+
integration = ApiKeyIntegration(integration_config.name, store=store)
|
62
|
+
if integration_config.credentials:
|
63
|
+
integration.set_credentials(integration_config.credentials)
|
64
|
+
return integration
|
65
|
+
elif integration_config.type == "agentr":
|
66
|
+
integration = AgentRIntegration(integration_config.name, api_key=integration_config.credentials.get("api_key") if integration_config.credentials else None)
|
67
|
+
return integration
|
68
|
+
return None
|
69
|
+
|
70
|
+
def _load_app(self, app_config: AppConfig):
|
71
|
+
name = app_config.name
|
72
|
+
integration = self._get_integration(app_config.integration)
|
73
|
+
app = app_from_name(name)(integration=integration)
|
74
|
+
return app
|
75
|
+
|
76
|
+
def _load_apps(self):
|
77
|
+
logger.info(f"Loading apps: {self.apps_list}")
|
78
|
+
for app_config in self.apps_list:
|
79
|
+
app = self._load_app(app_config)
|
80
|
+
if app:
|
81
|
+
tools = app.list_tools()
|
82
|
+
for tool in tools:
|
83
|
+
self.add_tool(tool)
|
84
|
+
|
85
|
+
|
86
|
+
|
87
|
+
class AgentRServer(Server):
|
88
|
+
"""
|
89
|
+
AgentR server. Connects to the AgentR API to get the apps and tools. Only supports agentr integrations.
|
90
|
+
"""
|
91
|
+
def __init__(self, name: str, description: str, api_key: str | None = None, **kwargs):
|
92
|
+
super().__init__(name, description=description, **kwargs)
|
93
|
+
self.api_key = api_key or os.getenv("AGENTR_API_KEY")
|
94
|
+
self.base_url = os.getenv("AGENTR_BASE_URL", "https://api.agentr.dev")
|
95
|
+
if not self.api_key:
|
96
|
+
raise ValueError("API key required - get one at https://agentr.dev")
|
97
|
+
self._load_apps()
|
98
|
+
|
99
|
+
def _load_app(self, app_config: AppConfig):
|
100
|
+
name = app_config.name
|
101
|
+
if app_config.integration:
|
102
|
+
integration_name = app_config.integration.name
|
103
|
+
integration = AgentRIntegration(integration_name, api_key=self.api_key)
|
104
|
+
else:
|
105
|
+
integration = None
|
106
|
+
app = app_from_name(name)(integration=integration)
|
107
|
+
return app
|
108
|
+
|
109
|
+
def _list_apps_with_integrations(self):
|
110
|
+
# TODO: get this from the API
|
111
|
+
response = httpx.get(
|
112
|
+
f"{self.base_url}/api/apps/",
|
113
|
+
headers={
|
114
|
+
"X-API-KEY": self.api_key
|
115
|
+
}
|
116
|
+
)
|
117
|
+
apps = response.json()
|
118
|
+
logger.info(f"Apps: {apps}")
|
119
|
+
return [AppConfig.model_validate(app) for app in apps]
|
120
|
+
|
121
|
+
def _load_apps(self):
|
122
|
+
apps = self._list_apps_with_integrations()
|
123
|
+
for app in apps:
|
124
|
+
app = self._load_app(app)
|
125
|
+
if app:
|
126
|
+
tools = app.list_tools()
|
127
|
+
for tool in tools:
|
128
|
+
self.add_tool(tool)
|
agentr/store.py
CHANGED
@@ -1,71 +1,71 @@
|
|
1
|
-
import os
|
2
|
-
from abc import ABC, abstractmethod
|
3
|
-
|
4
|
-
|
5
|
-
class Store(ABC):
|
6
|
-
@abstractmethod
|
7
|
-
def get(self, key: str):
|
8
|
-
pass
|
9
|
-
|
10
|
-
@abstractmethod
|
11
|
-
def set(self, key: str, value: str):
|
12
|
-
pass
|
13
|
-
|
14
|
-
@abstractmethod
|
15
|
-
def delete(self, key: str):
|
16
|
-
pass
|
17
|
-
|
18
|
-
class MemoryStore:
|
19
|
-
"""
|
20
|
-
Acts as credential store for the applications.
|
21
|
-
Responsible for storing and retrieving credentials.
|
22
|
-
Ideally should be a key value store
|
23
|
-
"""
|
24
|
-
def __init__(self):
|
25
|
-
self.data = {}
|
26
|
-
|
27
|
-
def get(self, key: str):
|
28
|
-
return self.data.get(key)
|
29
|
-
|
30
|
-
def set(self, key: str, value: str):
|
31
|
-
self.data[key] = value
|
32
|
-
|
33
|
-
def delete(self, key: str):
|
34
|
-
del self.data[key]
|
35
|
-
|
36
|
-
|
37
|
-
class EnvironmentStore(Store):
|
38
|
-
"""
|
39
|
-
Store that uses environment variables to store credentials.
|
40
|
-
"""
|
41
|
-
def __init__(self):
|
42
|
-
pass
|
43
|
-
|
44
|
-
def get(self, key: str):
|
45
|
-
return {"api_key": os.getenv(key)}
|
46
|
-
|
47
|
-
def set(self, key: str, value: str):
|
48
|
-
os.environ[key] = value
|
49
|
-
|
50
|
-
def delete(self, key: str):
|
51
|
-
del os.environ[key]
|
52
|
-
|
53
|
-
class RedisStore(Store):
|
54
|
-
"""
|
55
|
-
Store that uses a redis database to store credentials.
|
56
|
-
"""
|
57
|
-
def __init__(self, host: str, port: int, db: int):
|
58
|
-
import redis
|
59
|
-
self.host = host
|
60
|
-
self.port = port
|
61
|
-
self.db = db
|
62
|
-
self.redis = redis.Redis(host=self.host, port=self.port, db=self.db)
|
63
|
-
|
64
|
-
def get(self, key: str):
|
65
|
-
return self.redis.get(key)
|
66
|
-
|
67
|
-
def set(self, key: str, value: str):
|
68
|
-
self.redis.set(key, value)
|
69
|
-
|
70
|
-
def delete(self, key: str):
|
1
|
+
import os
|
2
|
+
from abc import ABC, abstractmethod
|
3
|
+
|
4
|
+
|
5
|
+
class Store(ABC):
|
6
|
+
@abstractmethod
|
7
|
+
def get(self, key: str):
|
8
|
+
pass
|
9
|
+
|
10
|
+
@abstractmethod
|
11
|
+
def set(self, key: str, value: str):
|
12
|
+
pass
|
13
|
+
|
14
|
+
@abstractmethod
|
15
|
+
def delete(self, key: str):
|
16
|
+
pass
|
17
|
+
|
18
|
+
class MemoryStore:
|
19
|
+
"""
|
20
|
+
Acts as credential store for the applications.
|
21
|
+
Responsible for storing and retrieving credentials.
|
22
|
+
Ideally should be a key value store
|
23
|
+
"""
|
24
|
+
def __init__(self):
|
25
|
+
self.data = {}
|
26
|
+
|
27
|
+
def get(self, key: str):
|
28
|
+
return self.data.get(key)
|
29
|
+
|
30
|
+
def set(self, key: str, value: str):
|
31
|
+
self.data[key] = value
|
32
|
+
|
33
|
+
def delete(self, key: str):
|
34
|
+
del self.data[key]
|
35
|
+
|
36
|
+
|
37
|
+
class EnvironmentStore(Store):
|
38
|
+
"""
|
39
|
+
Store that uses environment variables to store credentials.
|
40
|
+
"""
|
41
|
+
def __init__(self):
|
42
|
+
pass
|
43
|
+
|
44
|
+
def get(self, key: str):
|
45
|
+
return {"api_key": os.getenv(key)}
|
46
|
+
|
47
|
+
def set(self, key: str, value: str):
|
48
|
+
os.environ[key] = value
|
49
|
+
|
50
|
+
def delete(self, key: str):
|
51
|
+
del os.environ[key]
|
52
|
+
|
53
|
+
class RedisStore(Store):
|
54
|
+
"""
|
55
|
+
Store that uses a redis database to store credentials.
|
56
|
+
"""
|
57
|
+
def __init__(self, host: str, port: int, db: int):
|
58
|
+
import redis
|
59
|
+
self.host = host
|
60
|
+
self.port = port
|
61
|
+
self.db = db
|
62
|
+
self.redis = redis.Redis(host=self.host, port=self.port, db=self.db)
|
63
|
+
|
64
|
+
def get(self, key: str):
|
65
|
+
return self.redis.get(key)
|
66
|
+
|
67
|
+
def set(self, key: str, value: str):
|
68
|
+
self.redis.set(key, value)
|
69
|
+
|
70
|
+
def delete(self, key: str):
|
71
71
|
self.redis.delete(key)
|
agentr/test.py
CHANGED
@@ -1,38 +1,15 @@
|
|
1
|
-
from agentr.server import
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
},
|
16
|
-
{
|
17
|
-
"name": "zenquotes",
|
18
|
-
"integration": None
|
19
|
-
},
|
20
|
-
{
|
21
|
-
"name": "github",
|
22
|
-
"integration": {
|
23
|
-
"name": "github",
|
24
|
-
"type": "agentr",
|
25
|
-
}
|
26
|
-
}
|
27
|
-
]
|
28
|
-
mcp = TestServer(name="Test Server", description="Test Server", apps_list=apps_list)
|
29
|
-
|
30
|
-
async def test():
|
31
|
-
tools = await mcp.list_tools()
|
32
|
-
print(tools)
|
33
|
-
result = await mcp.call_tool("star_repository", {"repo_full_name": "manojbajaj95/config"})
|
34
|
-
print(result)
|
35
|
-
|
36
|
-
if __name__ == "__main__":
|
37
|
-
import asyncio
|
1
|
+
from agentr.server import AgentRServer
|
2
|
+
|
3
|
+
|
4
|
+
mcp = AgentRServer(name="Test Server", description="Test Server")
|
5
|
+
|
6
|
+
async def test():
|
7
|
+
tools = await mcp.list_tools()
|
8
|
+
from pprint import pprint
|
9
|
+
pprint(tools)
|
10
|
+
result = await mcp.call_tool("get_today_events", {})
|
11
|
+
print(result)
|
12
|
+
|
13
|
+
if __name__ == "__main__":
|
14
|
+
import asyncio
|
38
15
|
asyncio.run(test())
|