Skip to content

Commit f70de3f

Browse files
committed
docs: update codeboarding documentation and generate architecture
## 📚 Documentation Update This commit contains updated documentation files fetched from the CodeBoarding service and automatically generated architecture documentation. ### 📊 Summary - Documentation files created/updated: 6 - JSON files created/updated: 7 - Documentation directory: .codeboarding/ - JSON directory: .codeboarding/ - Output format: .mdx - Repository analyzed: https://github.com/CodeBoarding/mcp-use - Architecture documentation: docs/development/architecture.mdx (auto-generated) The generated .mdx files have been automatically appended to the development documentation, and the architecture.mdx file has been generated from the CodeBoarding analysis files. 🤖 This commit was automatically generated by the CodeBoarding documentation update workflow.
1 parent 481e5fe commit f70de3f

22 files changed

+1736
-1246
lines changed
Lines changed: 262 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,262 @@
1+
{
2+
"description": "This analysis provides accurate and verifiable information about the components, their relationships, and their roles within the `mcp_use` subsystem, based on updated feedback.",
3+
"components": [
4+
{
5+
"name": "BaseAdapter",
6+
"description": "BaseAdapter (located at mcp_use.adapters.base.BaseAdapter) serves as the abstract base class for all adapters within the framework. It defines a standardized interface for converting and managing external tools, resources, and prompts, making them consumable by the MCPAgent. This class is crucial for promoting a consistent and extensible integration strategy across diverse external systems.",
7+
"referenced_source_code": [
8+
{
9+
"qualified_name": "mcp_use.adapters.base.BaseAdapter",
10+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/base.py",
11+
"reference_start_line": 1,
12+
"reference_end_line": 1
13+
},
14+
{
15+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter",
16+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
17+
"reference_start_line": 1,
18+
"reference_end_line": 1
19+
}
20+
]
21+
},
22+
{
23+
"name": "LangChainAdapter",
24+
"description": "LangChainAdapter (located at mcp_use.adapters.langchain_adapter.LangChainAdapter) is a concrete implementation that integrates with the LangChain framework. It translates LangChain-specific tools, prompts, and resources into a format compatible with the MCPAgent. Notably, LangChainAdapter inherits from both BaseAdapter and MCPAgent, indicating its dual role: it acts as a specialized adapter for LangChain and can also function as an MCPAgent instance capable of directly leveraging LangChain functionalities.",
25+
"referenced_source_code": [
26+
{
27+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter",
28+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
29+
"reference_start_line": 1,
30+
"reference_end_line": 1
31+
},
32+
{
33+
"qualified_name": "mcp_use.adapters.base.BaseAdapter",
34+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/base.py",
35+
"reference_start_line": 1,
36+
"reference_end_line": 1
37+
},
38+
{
39+
"qualified_name": "mcp_use.agents.mcpagent.MCPAgent",
40+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/agents/mcpagent.py",
41+
"reference_start_line": 1,
42+
"reference_end_line": 1
43+
},
44+
{
45+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter._convert_prompt",
46+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
47+
"reference_start_line": 1,
48+
"reference_end_line": 1
49+
},
50+
{
51+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter._convert_resource",
52+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
53+
"reference_start_line": 1,
54+
"reference_end_line": 1
55+
},
56+
{
57+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter._convert_tool",
58+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
59+
"reference_start_line": 1,
60+
"reference_end_line": 1
61+
}
62+
]
63+
},
64+
{
65+
"name": "MCPAgent",
66+
"description": "MCPAgent (located at mcp_use.agents.mcpagent.MCPAgent) is the core AI agent responsible for orchestrating tasks, making decisions, and executing actions. It interacts with various adapters (like LangChainAdapter) to access and utilize tools and resources from external AI frameworks. The MCPAgent consumes the standardized output provided by these adapters, ensuring it remains decoupled from the specifics of external system implementations.",
67+
"referenced_source_code": [
68+
{
69+
"qualified_name": "mcp_use.agents.mcpagent.MCPAgent",
70+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/agents/mcpagent.py",
71+
"reference_start_line": 1,
72+
"reference_end_line": 1
73+
},
74+
{
75+
"qualified_name": "mcp_use.adapters.langchain_adapter.LangChainAdapter",
76+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/adapters/langchain_adapter.py",
77+
"reference_start_line": 1,
78+
"reference_end_line": 1
79+
},
80+
{
81+
"qualified_name": "mcp_use.managers.server_manager.ServerManager",
82+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/server_manager.py",
83+
"reference_start_line": 16,
84+
"reference_end_line": 89
85+
},
86+
{
87+
"qualified_name": "mcp_use.client.MCPClient",
88+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/client.py",
89+
"reference_start_line": 1,
90+
"reference_end_line": 1
91+
},
92+
{
93+
"qualified_name": "mcp_use.connectors.base.BaseConnector",
94+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/connectors/base.py",
95+
"reference_start_line": 1,
96+
"reference_end_line": 1
97+
},
98+
{
99+
"qualified_name": "mcp_use.telemetry.telemetry.Telemetry",
100+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/telemetry/telemetry.py",
101+
"reference_start_line": 55,
102+
"reference_end_line": 305
103+
}
104+
]
105+
},
106+
{
107+
"name": "ServerManager",
108+
"description": "ServerManager (located at mcp_use.managers.server_manager.ServerManager) is responsible for managing connections and interactions with various external servers. Contrary to the previous analysis, ServerManager inherits directly from MCPAgent, not BaseAdapter. This indicates that ServerManager is a specialized MCPAgent designed to handle server-related tasks, leveraging the agent's capabilities for managing connections and executing server-specific tools. It utilizes tools within mcp_use.managers.tools to perform its functions.",
109+
"referenced_source_code": [
110+
{
111+
"qualified_name": "mcp_use.managers.server_manager.ServerManager",
112+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/server_manager.py",
113+
"reference_start_line": 16,
114+
"reference_end_line": 89
115+
},
116+
{
117+
"qualified_name": "mcp_use.agents.mcpagent.MCPAgent",
118+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/agents/mcpagent.py",
119+
"reference_start_line": 1,
120+
"reference_end_line": 1
121+
},
122+
{
123+
"qualified_name": "mcp_use.client.MCPClient",
124+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/client.py",
125+
"reference_start_line": 1,
126+
"reference_end_line": 1
127+
},
128+
{
129+
"qualified_name": "mcp_use.managers.tools.connect_server.ConnectServerTool",
130+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/connect_server.py",
131+
"reference_start_line": 15,
132+
"reference_end_line": 68
133+
},
134+
{
135+
"qualified_name": "mcp_use.managers.tools.disconnect_server.DisconnectServerTool",
136+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/disconnect_server.py",
137+
"reference_start_line": 15,
138+
"reference_end_line": 42
139+
},
140+
{
141+
"qualified_name": "mcp_use.managers.tools.list_servers_tool.ListServersTool",
142+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/list_servers_tool.py",
143+
"reference_start_line": 15,
144+
"reference_end_line": 51
145+
},
146+
{
147+
"qualified_name": "mcp_use.managers.tools.get_active_server.GetActiveServerTool",
148+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/get_active_server.py",
149+
"reference_start_line": 13,
150+
"reference_end_line": 28
151+
}
152+
]
153+
},
154+
{
155+
"name": "MCPClient",
156+
"description": "MCPClient is responsible for managing sessions and connections, interacting with MCPAgent and ServerManager.",
157+
"referenced_source_code": [
158+
{
159+
"qualified_name": "mcp_use.client.MCPClient",
160+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/client.py",
161+
"reference_start_line": 1,
162+
"reference_end_line": 1
163+
},
164+
{
165+
"qualified_name": "mcp_use.agents.mcpagent.MCPAgent",
166+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/agents/mcpagent.py",
167+
"reference_start_line": 1,
168+
"reference_end_line": 1
169+
},
170+
{
171+
"qualified_name": "mcp_use.managers.server_manager.ServerManager",
172+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/server_manager.py",
173+
"reference_start_line": 16,
174+
"reference_end_line": 89
175+
}
176+
]
177+
},
178+
{
179+
"name": "MCPServerTool",
180+
"description": "MCPServerTool serves as the base class for various server management tools used by ServerManager.",
181+
"referenced_source_code": [
182+
{
183+
"qualified_name": "mcp_use.managers.tools.base_tool.MCPServerTool",
184+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/base_tool.py",
185+
"reference_start_line": 5,
186+
"reference_end_line": 18
187+
},
188+
{
189+
"qualified_name": "mcp_use.managers.tools.connect_server.ConnectServerTool",
190+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/connect_server.py",
191+
"reference_start_line": 15,
192+
"reference_end_line": 68
193+
},
194+
{
195+
"qualified_name": "mcp_use.managers.tools.disconnect_server.DisconnectServerTool",
196+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/disconnect_server.py",
197+
"reference_start_line": 15,
198+
"reference_end_line": 42
199+
},
200+
{
201+
"qualified_name": "mcp_use.managers.tools.list_servers_tool.ListServersTool",
202+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/list_servers_tool.py",
203+
"reference_start_line": 15,
204+
"reference_end_line": 51
205+
},
206+
{
207+
"qualified_name": "mcp_use.managers.tools.get_active_server.GetActiveServerTool",
208+
"reference_file": "/mnt/e/StartUp/mcp-use/mcp_use/managers/tools/get_active_server.py",
209+
"reference_start_line": 13,
210+
"reference_end_line": 28
211+
}
212+
]
213+
}
214+
],
215+
"components_relations": [
216+
{
217+
"relation": "inherits from",
218+
"src_name": "LangChainAdapter",
219+
"dst_name": "BaseAdapter"
220+
},
221+
{
222+
"relation": "inherits from",
223+
"src_name": "LangChainAdapter",
224+
"dst_name": "MCPAgent"
225+
},
226+
{
227+
"relation": "inherits from",
228+
"src_name": "ServerManager",
229+
"dst_name": "MCPAgent"
230+
},
231+
{
232+
"relation": "uses",
233+
"src_name": "MCPAgent",
234+
"dst_name": "BaseAdapter"
235+
},
236+
{
237+
"relation": "uses",
238+
"src_name": "MCPAgent",
239+
"dst_name": "LangChainAdapter"
240+
},
241+
{
242+
"relation": "uses",
243+
"src_name": "MCPAgent",
244+
"dst_name": "ServerManager"
245+
},
246+
{
247+
"relation": "uses",
248+
"src_name": "ServerManager",
249+
"dst_name": "MCPServerTool"
250+
},
251+
{
252+
"relation": "uses",
253+
"src_name": "MCPClient",
254+
"dst_name": "MCPAgent"
255+
},
256+
{
257+
"relation": "uses",
258+
"src_name": "MCPClient",
259+
"dst_name": "ServerManager"
260+
}
261+
]
262+
}

0 commit comments

Comments
 (0)