
Mcp Arangodb Async
io.github.PCfVW由 GitHub 账号 PCfVW 发布v0.5.4更新于 Oct 24, 2026
Async MCP server for ArangoDB: 46 tools for graphs, queries, and multi-tenancy.
发布方自己的服务:AsyncFlow
概览
一个本地 MCP 服务器,为 AI 助手提供 46 个工具,用于查询、修改和分析 ArangoDB 数据库,包括图和多租户。
- 可以做什么
- 执行 AQL 查询,构建、解释和剖析查询,查看数据库状态与集合,并在多个已配置数据库间切换会话焦点数据库、解析实际使用的数据库。插入、更新、删除和批量写入文档,创建集合,备份集合。创建、列出和删除索引,并按 JSON schema 校验文档与引用。创建命名图,添加顶点与边集合及边定义,添加顶点和边,遍历图并查找最短路径。备份、恢复和校验图,读取图统计信息。搜索和列出服务器自身的工具,切换工作流,卸载工具以节省上下文。
- 适用场景
- 适合需要让助手直接操作 ArangoDB 的场景:浏览集合、编写和调优 AQL、把数据建模为图(例如代码依赖分析),或在同一会话中管理多个数据库。面向已运行 ArangoDB 并希望以对话方式完成数据库工作的开发者和分析人员。
- 运行要求
- 以本地 Python 进程运行(需 Python 3.11+),从 PyPI 安装,并需要可通过网络访问的 ArangoDB 服务器。README 通过 MCP 主机配置中的环境变量 ARANGO_URL、ARANGO_DB、ARANGO_USERNAME 和 ARANGO_PASSWORD 设置连接;ArangoDB 本身建议用 Docker 运行。
安装
在 SourceWeft 中
- 打开 控制台中的 Mcp Arangodb Async,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
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
来源:README.md,提交 63b22f5
工具
0版本历史
1- v0.5.4最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Async 集成

AsyncFlow
om.async官方发布者
远程 AsyncFlow 连接器,让助手在公司工作区中搜索、读取、创建、更新、指派、评论和归档工单。

AsyncAPI channel count, body discarded
由 GitHub 账号 sadri-dridi 发布
一个远程 MCP 端点,提供时间、URL 与主机名解析、HTTP 状态检查、简单校验和少量索引查询等小型工具。

Open & Async
com.open-and-async
本地 stdio MCP 服务器,让助手起草决策文档、把会议转为异步产出、给状态更新打分,并判断该同步还是异步。