
Mcp Arangodb Async
io.github.PCfVWPublished by GitHub account PCfVWv0.5.4Updated Oct 24, 2026
Async MCP server for ArangoDB: 46 tools for graphs, queries, and multi-tenancy.
The publisher's own server: AsyncFlow
Overview
A local MCP server that gives an AI assistant 46 tools to query, modify, and analyze an ArangoDB database, including graphs and multi-tenancy.
- What you can do
- Run AQL queries, build, explain and profile them, and inspect database status and collections across configured databases, including switching the focused database for a session and resolving which database is used. Insert, update, remove and bulk-load documents, create collections, and back up collections. Create, list and delete indexes, and validate documents and references against JSON schemas. Create named graphs, add vertex and edge collections and definitions, add vertices and edges, traverse graphs and find shortest paths. Back up, restore and validate graphs, and read graph statistics. Search and list the server's own tools, switch workflows, and unload tools to save context.
- When to use it
- Useful when an assistant needs to work directly with an ArangoDB instance: exploring collections, writing and tuning AQL, modeling data as graphs such as code dependencies, or managing several databases from one session. It is aimed at developers and analysts who already run ArangoDB and want database work done conversationally.
- Requirements
- Runs as a local Python process (Python 3.11+) installed from PyPI, with an ArangoDB server reachable over the network. The README configures the connection through environment variables ARANGO_URL, ARANGO_DB, ARANGO_USERNAME and ARANGO_PASSWORD in the MCP host configuration; Docker is suggested for running ArangoDB itself.
Installation
In SourceWeft
- Open Mcp Arangodb Async in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
ArangoDB MCP Server for Python
[Python] [License] [MCP] [PyPI]
A production-ready Model Context Protocol (MCP) server exposing advanced ArangoDB operations to AI assistants like Claude Desktop and Augment Code. Features async-first Python architecture, comprehensive graph management, flexible content conversion (JSON, Markdown, YAML, Table), backup/restore functionality, and analytics capabilities.
Quick Links
📚 Documentation: https://github.com/PCfVW/mcp-arango-async/tree/master/docs
🚀 Quick Start: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/getting-started/quickstart.md
🔧 ArangoDB Setup: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/getting-started/install-arangodb.md
🗄️ Multi-Tenancy Guide: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/multi-tenancy-guide.md
⚙️ CLI Reference: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/cli-reference.md
📖 Tools Reference: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/tools-reference.md
🎯 MCP Design Patterns: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/mcp-design-patterns.md
📝 Changelog: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/developer-guide/changelog.md
🐛 Issues: https://github.com/PCfVW/mcp-arango-async/issues
Features
- ✅ 46 MCP Tools - Complete ArangoDB operations (queries, collections, indexes, graphs)
- ✅ Multi-Tenancy - Work with multiple databases, environment switching, cross-database operations
- ✅ MCP Design Patterns - Progressive discovery, context switching, tool unloading (98.7% token savings)
- ✅ Graph Management - Create, traverse, backup/restore named graphs
- ✅ Content Conversion - JSON, Markdown, YAML, and Table formats
- ✅ Backup/Restore - Collection and graph-level backup with validation
- ✅ Analytics - Query profiling, explain plans, graph statistics
- ✅ Dual Transport - stdio (desktop clients) and HTTP (web/containerized)
- ✅ Docker Support - Run in Docker for isolation and reproducibility
- ✅ Production-Ready - Retry logic, graceful degradation, comprehensive error handling
- ✅ Type-Safe - Pydantic validation for all tool arguments
Architecture
Getting Started with ArangoDB
Prerequisites
- Docker and Docker Compose installed
- Python 3.11+ (for mcp-arangodb-async)
Step 1: Install ArangoDB
Create a docker-compose.yml file:
Create a .env file:
Start ArangoDB:
Step 2: Install mcp-arangodb-async
Install the MCP server package:
Alternative: Install with Conda/Mamba/Micromamba
Alternative: Install with uv
Step 3: Create Database and User
Create the database and user for the MCP server:
Expected output:
Verify the database connection:
Expected output:
Step 4: Configure MCP Host
Configure your MCP host to use the server. The configuration includes environment variables for database connection. The location of the configuration file depends on your MCP host. For Claude Desktop, the file is located at:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Configuration:
Alternative: Configuration for Conda/Mamba/Micromamba
If you installed with conda/mamba/micromamba, use the run command:
Replace "conda" with "mamba" or "micromamba" if using those tools.
Alternative: Configuration for uv
If you installed with uv, use uv run:
Replace /path/to/project with the directory containing your .venv folder.
Restart your MCP client after updating the configuration.
Test the connection:
Ask your MCP client: "List all collections in the ArangoDB database"
The assistant should successfully connect and list your collections.
Available Tools
The server exposes 46 MCP tools organized into 11 categories:
Multi-Tenancy Tools (4 tools)
arango_set_focused_database- Set focused database for sessionarango_get_focused_database- Get currently focused databasearango_list_available_databases- List all configured databasesarango_get_database_resolution- Show database resolution algorithm
Core Data Operations (7 tools)
arango_query- Execute AQL queriesarango_list_collections- List all collectionsarango_insert- Insert documentsarango_update- Update documentsarango_remove- Remove documentsarango_create_collection- Create collectionsarango_backup- Backup collections
Index Management (3 tools)
arango_list_indexes- List indexesarango_create_index- Create indexesarango_delete_index- Delete indexes
Query Analysis (3 tools)
arango_explain_query- Explain query execution planarango_query_builder- Build AQL queriesarango_query_profile- Profile query performance
Data Validation (4 tools)
arango_validate_references- Validate document referencesarango_insert_with_validation- Insert with validationarango_create_schema- Create JSON schemasarango_validate_document- Validate against schema
Bulk Operations (2 tools)
arango_bulk_insert- Bulk insert documentsarango_bulk_update- Bulk update documents
Graph Management (7 tools)
arango_create_graph- Create named graphsarango_list_graphs- List all graphsarango_add_vertex_collection- Add vertex collectionsarango_add_edge_definition- Add edge definitionsarango_add_vertex- Add verticesarango_add_edge- Add edgesarango_graph_traversal- Traverse graphs
Graph Traversal (2 tools)
arango_traverse- Graph traversalarango_shortest_path- Find shortest paths
Graph Backup/Restore (5 tools)
arango_backup_graph- Backup single grapharango_restore_graph- Restore single grapharango_backup_named_graphs- Backup all named graphsarango_validate_graph_integrity- Validate graph integrityarango_graph_statistics- Graph statistics
Health & Status (1 tool)
arango_database_status- Get comprehensive status of all databases
Tool Aliases (2 tools)
arango_graph_traversal- Alias for arango_traversearango_add_vertex- Alias for arango_insert
MCP Design Pattern Tools (8 tools)
arango_search_tools- Search for tools by keywordsarango_list_tools_by_category- List tools by categoryarango_switch_workflow- Switch workflow contextarango_get_active_workflow- Get active workflowarango_list_workflows- List all workflowsarango_advance_workflow_stage- Advance workflow stagearango_get_tool_usage_stats- Get tool usage statisticsarango_unload_tools- Unload specific tools
📖 Complete tools reference: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/tools-reference.md
📖 MCP Design Patterns Guide: https://github.com/PCfVW/mcp-arango-async/blob/master/docs/user-guide/mcp-design-patterns.md
Use Case Example: Codebase Graph Analysis
Model your codebase as a graph to analyze dependencies, find circular references, and understand architecture. Here is an excerpt from the longer codebase analysis example:
Documentation
Getting Started
Configuration
User Guide
Developer Guide
Examples
📖 Full documentation: https://github.com/PCfVW/mcp-arango-async/tree/master/docs
Troubleshooting
Common Issues
Database connection fails:
Server won't start in Claude Desktop:
Tool execution errors:
- Verify ArangoDB is healthy:
docker compose ps - Check environment variables are set correctly
- Review server logs for detailed error messages
📖 Complete troubleshooting guide
Why Docker for ArangoDB?
✅ Stability - Isolated environment, no host conflicts
✅ Zero-install - Start/stop with docker compose
✅ Reproducibility - Same image across all environments
✅ Health checks - Built-in readiness validation
✅ Fast reset - Recreate clean instances easily
✅ Portability - Consistent on Windows/macOS/Linux
License
- This project: Apache License 2.0
- ArangoDB 3.11: Apache License 2.0
- ArangoDB 3.12+: Business Source License 1.1 (BUSL-1.1)
⚠️ Important: This repository does not grant rights to ArangoDB binaries. You must comply with ArangoDB's license for your deployment version.
Contributing
Contributions are welcome! Please see our documentation for guidelines.
Support
Acknowledgments
Built with:
- Model Context Protocol by Anthropic
- python-arango - Official ArangoDB Python driver
- Pydantic - Data validation
- Starlette - HTTP transport
- ArangoDB - Multi-model database
Source: README.md at commit 63b22f5
Tools
0Version history
1- v0.5.4LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Other Async integrations

AsyncFlow
om.asyncOfficial publisher
Remote AsyncFlow connector that lets an assistant search, read, create, update, assign, comment on and archive tickets in your company's workspaces.

AsyncAPI channel count, body discarded
Published by GitHub account sadri-dridi
A remote MCP endpoint of small utility tools: time, URL and hostname parsing, HTTP status checks, simple validation, and a few index lookups.

Open & Async
com.open-and-async
Local stdio MCP server that gives an assistant tools to draft decision docs, convert meetings to async artifacts, score status updates and triage sync vs async.