11# ArangoDB MCP Server for Python
22
33[ ![ Python] ( https://img.shields.io/badge/Python-3.11%2B-blue )] ( https://www.python.org/ )
4- [ ![ License] ( https://img.shields.io/badge/License-Apache_2.0-green.svg )] ( https://github.com/PCfVW/mcp-arango-async/blob/main /LICENSE )
4+ [ ![ License] ( https://img.shields.io/badge/License-Apache_2.0-green.svg )] ( https://github.com/PCfVW/mcp-arango-async/blob/master /LICENSE )
55[ ![ MCP] ( https://img.shields.io/badge/Protocol-MCP-%23555555 )] ( https://modelcontextprotocol.io/ )
66[ ![ PyPI] ( https://img.shields.io/pypi/v/mcp-arangodb-async )] ( https://pypi.org/project/mcp-arangodb-async/ )
77
@@ -11,10 +11,10 @@ A production-ready Model Context Protocol (MCP) server exposing advanced ArangoD
1111
1212## Quick Links
1313
14- 📚 ** Documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/main /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/main /docs )
15- 🚀 ** Quick Start:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/quickstart-stdio.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/quickstart-stdio.md )
16- 🔧 ** Installation:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md )
17- 📖 ** Tools Reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/tools-reference.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/tools-reference.md )
14+ 📚 ** Documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/master /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/master /docs )
15+ 🚀 ** Quick Start:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/quickstart-stdio.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/quickstart-stdio.md )
16+ 🔧 ** Installation:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md )
17+ 📖 ** Tools Reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/tools-reference.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/tools-reference.md )
1818🐛 ** Issues:** [ https://github.com/PCfVW/mcp-arango-async/issues ] ( https://github.com/PCfVW/mcp-arango-async/issues )
1919
2020---
@@ -75,7 +75,7 @@ python -m mcp_arangodb_async --health
7575{"status" : " healthy" , "database_connected" : true , "database_info" : {"version" : " 3.11.x" , "name" : " mcp_arangodb_test" }}
7676```
7777
78- 📖 ** Detailed installation guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md )
78+ 📖 ** Detailed installation guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md )
7979
8080---
8181
@@ -92,12 +92,12 @@ Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/.config/Claud
9292 "mcpServers" : {
9393 "arangodb" : {
9494 "command" : " python" ,
95- "args" : [" -m" , " mcp_arangodb_async" ],
95+ "args" : [" -m" , " mcp_arangodb_async" , " server " ],
9696 "env" : {
9797 "ARANGO_URL" : " http://localhost:8529" ,
9898 "ARANGO_DB" : " mcp_arangodb_test" ,
99- "ARANGO_USERNAME" : " root " ,
100- "ARANGO_PASSWORD" : " changeme "
99+ "ARANGO_USERNAME" : " mcp_arangodb_user " ,
100+ "ARANGO_PASSWORD" : " mcp_arangodb_password "
101101 }
102102 }
103103 }
@@ -110,7 +110,7 @@ Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/.config/Claud
110110
111111Ask Claude: * "List all collections in the ArangoDB database"*
112112
113- 📖 ** Full stdio quickstart:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/quickstart-stdio.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/quickstart-stdio.md )
113+ 📖 ** Full stdio quickstart:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/quickstart-stdio.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/quickstart-stdio.md )
114114
115115---
116116
@@ -142,7 +142,7 @@ await client.connect();
142142const tools = await client .listTools ();
143143```
144144
145- 📖 ** HTTP transport guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/http-transport.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/http-transport.md )
145+ 📖 ** HTTP transport guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/http-transport.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/http-transport.md )
146146
147147---
148148
@@ -175,7 +175,7 @@ ARANGO_CONNECT_DELAY_SEC=1.0 # Retry delay
175175LOG_LEVEL=INFO # DEBUG, INFO, WARNING, ERROR
176176```
177177
178- 📖 ** Complete configuration reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/configuration/environment-variables.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/configuration/environment-variables.md )
178+ 📖 ** Complete configuration reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/configuration/environment-variables.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/configuration/environment-variables.md )
179179
180180---
181181
@@ -235,7 +235,7 @@ The server exposes **34 MCP tools** organized into 9 categories:
235235- ` arango_graph_statistics ` - Graph statistics
236236- ` arango_database_status ` - Database status
237237
238- 📖 ** Complete tools reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/tools-reference.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/tools-reference.md )
238+ 📖 ** Complete tools reference:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/tools-reference.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/tools-reference.md )
239239
240240---
241241
@@ -261,35 +261,35 @@ Ask Claude: "Check for circular dependencies in the codebase graph"
261261Ask Claude: " Export the codebase graph structure as Markdown for visualization"
262262```
263263
264- 📖 ** More examples:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/examples/codebase-analysis.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/examples/codebase-analysis.md )
264+ 📖 ** More examples:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/examples/codebase-analysis.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/examples/codebase-analysis.md )
265265
266266---
267267
268268## Documentation
269269
270270### Getting Started
271- - [ Installation Guide] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md )
272- - [ Quick Start (stdio)] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/quickstart-stdio.md )
273- - [ First Interaction] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/first-interaction.md )
271+ - [ Installation Guide] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md )
272+ - [ Quick Start (stdio)] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/quickstart-stdio.md )
273+ - [ First Interaction] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/first-interaction.md )
274274
275275### Configuration
276- - [ Transport Configuration] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/configuration/transport-configuration.md )
277- - [ Environment Variables] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/configuration/environment-variables.md )
276+ - [ Transport Configuration] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/configuration/transport-configuration.md )
277+ - [ Environment Variables] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/configuration/environment-variables.md )
278278
279279### User Guide
280- - [ Tools Reference] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/tools-reference.md )
281- - [ Troubleshooting] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/troubleshooting.md )
280+ - [ Tools Reference] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/tools-reference.md )
281+ - [ Troubleshooting] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/troubleshooting.md )
282282
283283### Developer Guide
284- - [ Architecture Overview] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/architecture.md )
285- - [ Low-Level MCP Rationale] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/low-level-mcp-rationale.md )
286- - [ HTTP Transport] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/http-transport.md )
287- - [ Changelog] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/changelog.md )
284+ - [ Architecture Overview] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/architecture.md )
285+ - [ Low-Level MCP Rationale] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/low-level-mcp-rationale.md )
286+ - [ HTTP Transport] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/http-transport.md )
287+ - [ Changelog] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/changelog.md )
288288
289289### Examples
290- - [ Codebase Dependency Analysis] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/examples/codebase-analysis.md )
290+ - [ Codebase Dependency Analysis] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/examples/codebase-analysis.md )
291291
292- 📖 ** Full documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/main /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/main /docs )
292+ 📖 ** Full documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/master /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/master /docs )
293293
294294---
295295
@@ -327,7 +327,7 @@ python -m mcp_arangodb_async --health
327327- Check environment variables are set correctly
328328- Review server logs for detailed error messages
329329
330- 📖 ** Complete troubleshooting guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/troubleshooting.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/user-guide/troubleshooting.md )
330+ 📖 ** Complete troubleshooting guide:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/troubleshooting.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/user-guide/troubleshooting.md )
331331
332332---
333333
@@ -350,23 +350,23 @@ python -m mcp_arangodb_async --health
350350
351351⚠️ ** Important:** This repository does not grant rights to ArangoDB binaries. You must comply with ArangoDB's license for your deployment version.
352352
353- 📖 ** License details:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md#arangodb-licensing ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/getting-started/installation.md#arangodb-licensing )
353+ 📖 ** License details:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md#arangodb-licensing ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/getting-started/installation.md#arangodb-licensing )
354354
355355---
356356
357357## Contributing
358358
359359Contributions are welcome! Please see our documentation for guidelines.
360360
361- 📖 ** Architecture decisions:** [ https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/low-level-mcp-rationale.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/main /docs/developer-guide/low-level-mcp-rationale.md )
361+ 📖 ** Architecture decisions:** [ https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/low-level-mcp-rationale.md ] ( https://github.com/PCfVW/mcp-arango-async/blob/master /docs/developer-guide/low-level-mcp-rationale.md )
362362
363363---
364364
365365## Support
366366
367367- ** Issues:** [ https://github.com/PCfVW/mcp-arango-async/issues ] ( https://github.com/PCfVW/mcp-arango-async/issues )
368368- ** Discussions:** [ https://github.com/PCfVW/mcp-arango-async/discussions ] ( https://github.com/PCfVW/mcp-arango-async/discussions )
369- - ** Documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/main /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/main /docs )
369+ - ** Documentation:** [ https://github.com/PCfVW/mcp-arango-async/tree/master /docs ] ( https://github.com/PCfVW/mcp-arango-async/tree/master /docs )
370370
371371---
372372
0 commit comments