ADK MCP Server
Provides search capabilities for Google ADK documentation, allowing AI agents to query and retrieve relevant documentation chunks from the Accessory Development Kit.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ADK MCP Server search ADK docs for battery optimization"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ADK MCP Server
An offline-first Model Context Protocol (MCP) server for querying Google ADK (Accessory Development Kit) documentation. This server uses LanceDB for vector search and FastMCP for the MCP interface, allowing AI models to access and understand ADK documentation.
Features
Offline-first: All documentation and vector indices are stored locally.
Fast Search: Uses LanceDB and FastEmbed for efficient vector search.
MCP Integration: Compatible with any MCP-enabled client (like Claude Desktop).
Easy Deployment: Can be installed as a local tool using
uv.
Related MCP server: MCP Local Context
Prerequisites
Python 3.13 or higher
uv for dependency management and running.
Installation
Clone the repository:
git clone <repository-url> cd adk-mcp-docsInstall dependencies:
make install # or uv sync
Usage
1. Build the Index
Before running the server, you need to build the vector index from the documentation.
make build-index
# or
uv run src/adk_mcp/builder.py2. Run the Server (Development)
To run the server in development mode with hot-reloading:
make run
# or
uv run fastmcp run src/adk_mcp/server.py3. Local Deployment
To install the server as a local tool accessible via uvx:
make deploy-local
# or
uv tool install . --forceAfter installation, you can run the server using:
uvx adk-mcpConfiguration for MCP Clients
VS Code / Antigravity
For VS Code (with compatible MCP extensions) or Antigravity, create a file at .vscode/mcp-servers.json with the following content:
{
"mcpServers": {
"adk-mcp": {
"command": "uvx",
"args": ["adk-mcp"]
}
}
}Cursor
Open Cursor Settings.
Go to Features > MCP.
Click + Add Bot.
Set Name to
adk-mcp.Set Type to
command.Set Command to
uvx adk-mcp.
Claude Desktop
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"adk-mcp": {
"command": "uvx",
"args": ["adk-mcp"]
}
}
}Project Structure
src/adk_mcp/: Source code for the MCP server.builder.py: Script to build the LanceDB index.server.py: FastMCP server implementation.data/: Directory for storing the LanceDB index (generated).
data/: (Optional) Source documentation files (if not embedded in the package).Makefile: Convenient shortcuts for common tasks.pyproject.toml: Project metadata and dependencies.
Chunking Strategy
The documentation is indexed using a context-aware chunking strategy to ensure high-quality search results:
Header-based Splitting: Files are split by H1, H2, and H3 headers.
Contextual Headers: Each chunk is prefixed with its hierarchical context (e.g.,
Context: Getting Started > Installation > Python).Language Tab Handling: Special handling for documentation with language tabs (e.g.,
=== "Python",=== "Go"). Content within these tabs is indexed separately and tagged with the respective language.Embeddings: Uses the
BAAI/bge-small-en-v1.5model for generating vector embeddings.
Available Tools
search_adk
Search the Google ADK documentation for relevant information.
Arguments:
query(string): The search query.language(string): The programming language to filter by. Supported values:"python","go","java", or"all".
Returns:
A formatted string containing the top 5 relevant chunks, including their source URLs and content.
Available Tools
1 toolsearch_adkB
Search the Google ADK documentation for relevant information.
Args: query: The search query. language: The programming language to filter by ("python", "go", "java", or "all").
Inputs: query (required), language (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools. The tool's purpose is clear and distinct, so disambiguation is not a concern.
The tool name 'search_adk' follows a clear verb_noun pattern, and with only one tool there are no inconsistencies. The naming is predictable and appropriate.
A single tool is on the borderline of being too thin, but for a documentation search server, it may be sufficient. However, it feels limited compared to typical MCP servers with a broader toolset.
The search tool covers the primary need of querying ADK documentation with language filtering. However, it lacks tools for retrieving full document content or browsing available topics, which are minor gaps.
Maintenance
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context20 npm263MIT
- AlicenseNot gradedqualityDmaintenanceA simple MCP server for local documentation with RAG capabilities, enabling AI assistants to access and search local documents.2MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents direct access to developer.android.com — search docs, look up API references, browse packages, and check release notes.9Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.10 npmMIT