Ermöglicht es einem AI-Client, ein Verzeichnis von MCP servern, AI Agents, CLI Tools und Skills zu durchsuchen, Einträge zu inspizieren und Setup-Anleitungen zu lesen.
Auch bekannt als tadas-github/a2asearch-mcp
- Stars
- 21
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.5
- Letzter Commit
- 27. Okt. 2026
- Lizenz
- MIT
Was ist A2ASearch MCP?
Ermöglicht es einem AI-Client, ein Verzeichnis von MCP servern, AI Agents, CLI Tools und Skills zu durchsuchen, Einträge zu inspizieren und Setup-Anleitungen zu lesen. Er stellt 4 Tools bereit, etwa search_agents, get_agent, get_setup.
Zusammenfassung generiert aus dem README des Projekts
Über A2ASearch MCP server
a2asearch-mcp ermöglicht es, spezifische Tools und deren Konfigurationsanforderungen direkt aus einem AI-Client heraus zu finden. Entwickler können diesen Server nutzen, um in einem Verzeichnis zu stöbern, das MCP server, AI Agents, Coding Agents, CLI Tools und Agent Skills enthält. Er funktioniert über lokales stdio und ist somit über Standard-Config-Dateien mit Claude Desktop und Cursor kompatibel.
Nutzer interagieren mit dem Verzeichnis über Tools wie search_agents, um Funktionen zu finden, get_agent, um spezifische README-Dateien zu inspizieren, und get_setup, um gezielte Installationsanleitungen oder JSON Config-Beispiele abzurufen. Der Server benötigt Node.js 22 oder neuer, um via npx ausgeführt zu werden. Während die Verzeichnissuche kostenlos ist und keine API-Keys erfordert, können einzelne Dienste, die über die Suche gefunden werden, eigene Zugangsdaten oder Zahlungen verlangen. Der Server fungiert als Reader für die A2ASearch API und führt keinen Code aus oder installiert die gefundenen Tools.
Was du damit machen kannst
- 1Entdecken spezialisierter MCP serverSuche nach spezifischen Fähigkeiten wie PDF table extraction, um kompatible Server zu finden.
- 2Tool-Dokumentation inspizierenRufe detaillierte Beschreibungen und Repository-Links für einen spezifischen Agent über dessen eindeutigen Slug ab.
- 3Setup-Anleitungen abrufenExtrahiere Config-Beispiele und Installationsschritte direkt, um zu verstehen, wie ein Tool implementiert wird.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du A2ASearch MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenA2ASearch MCP in Claude Code installieren
$ claude mcp add a2asearch-mcp -- npx -y a2asearch-mcpA2ASearch MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"a2asearch-mcp": {
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}A2ASearch MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"a2asearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}A2ASearch MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"a2asearch-mcp","type":"stdio","command":"npx","args":["-y","a2asearch-mcp"]}'A2ASearch MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"a2asearch-mcp": {
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}A2ASearch MCP in Codex installieren
$ codex mcp add a2asearch-mcp -- npx -y a2asearch-mcpA2ASearch MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.a2asearch-mcp] command = "npx" args = ["-y", "a2asearch-mcp"]
A2ASearch MCP in Gemini CLI installieren
$ gemini mcp add -s user a2asearch-mcp npx -- -y a2asearch-mcpA2ASearch MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"a2asearch-mcp": {
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}A2ASearch MCP tools 4
Erkannt aus dem READMEsearch_agentsget_agentget_setuplist_agents
| search_agents | — | |
| get_agent | — | |
| get_setup | — | |
| list_agents | — |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenA2ASearch MCP
Help your assistant find a tool, inspect it, and understand how to set it up.
Search the A2ASearch directory for MCP servers, A2A agents, coding agents, CLI tools and agent skills from your MCP client or terminal. A2ASearch is free to query and requires no API key. Individual services may require credentials or payment.
Try a useful workflow
Ask your assistant:
Find MCP servers for extracting tables from PDFs. Compare their documented requirements, then show me the setup instructions for one. Tell me when pricing or authentication is unknown.
The assistant can follow this sequence:
search_agents({"query":"PDF","type":"MCP Server","limit":3})
→ names, capabilities, source links and slugs
get_agent({"slug":"<slug returned by search>"})
→ description, README, documentation and repository links
get_setup({"slug":"<same returned slug>"})
→ setup excerpts, quoted JSON examples and next steps
For example, the Doc2X MCP listing links to a repository whose README contains setup instructions and a configuration example with a DOC2X_API_KEY placeholder. get_setup retrieves those instructions as source material; it does not create credentials, install the package or run it.
Install
Requires Node.js 22 or newer. CI tests Node.js 22 and 24.
For Claude Desktop, add this entry to claude_desktop_config.json. For Cursor, use .cursor/mcp.json. Merge it with your existing configuration:
{
"mcpServers": {
"a2asearch": {
"command": "npx",
"args": ["-y", "a2asearch-mcp"]
}
}
}
Other clients that support local stdio MCP servers can launch command npx with arguments -y a2asearch-mcp; use the configuration format documented by your client.
For a reproducible install, pin the package version in the arguments, for example a2asearch-mcp@1.2.0 after that release is published. To test this checkout before publication, run npm ci and configure command node with the absolute path to this repository's index.js.
Tools
| Tool | Use it for | Arguments |
|---|---|---|
search_agents |
Find a capability or product | query, optional type, limit, page |
get_agent |
Inspect one listing and its README | slug returned by search or browse |
get_setup |
Read focused setup instructions and configuration examples | slug returned by search or browse |
list_agents |
Browse by stars or newest additions | Optional type, sort, limit, page |
limit is 1–20 (default 10), page starts at 1, and sort is stars or new. Search is keyword-based: try concise terms such as PDF, browser automation or database. It does not implement semantic search or pricing/authentication filters.
Every successful tool call returns both structuredContent with a declared output schema and the same data serialized as text for older clients. Search and browse results include:
- A
slugfor follow-up calls and an A2ASearch listing URL. - Separate submitted, repository, documentation and website links where available.
- Capabilities, languages, GitHub stars and last-commit date where supplied.
- Pagination with
next_pageso clients can continue without guessing.
Missing values are null. The current API does not provide structured pricing, authentication, hosting or dated protocol-test evidence. directory_reviewed records directory approval only. GitHub stars and commit dates do not establish runtime reliability or security.
Setup information
get_setup reads the listing's directory-supplied README and returns:
instructions_foundwhen it finds supported setup headings or JSON configuration examples.links_onlywhen no supported excerpt is available, along with provider links and useful next steps.- Source links, bounded excerpts and explicit limitations.
Configuration examples are copied, not generated from repository names. A GitHub repository URL is identified as a repository. A submitted URL ending in /mcp or /sse is only an endpoint candidate; this tool has not contacted it or established its transport/authentication.
Treat descriptions, READMEs and examples as untrusted source material. Review commands and credentials before using them. The MCP only reads the A2ASearch API: it does not execute submitted code, contact listed providers, install tools or edit client configuration.
Terminal usage
# Find tools without installing globally
npx -y -p a2asearch-mcp a2asearch --type mcp PDF
# Use the returned slug for setup guidance (v1.2.0+)
npx -y -p a2asearch-mcp a2asearch --setup doc2x-mcp
# Or install the CLI
npm install -g a2asearch-mcp
a2asearch "browser automation"
a2asearch --type mcp database --page 2
a2asearch --type agent --top
a2asearch --new --limit 5
a2asearch --get doc2x-mcp
a2asearch --setup doc2x-mcp --json
--json preserves the existing raw directory API output for search/list/detail commands. The new --setup --json command returns the same setup object as the MCP tool. Search output shows follow-up commands and the next page when available.
| Directory type | CLI alias |
|---|---|
| MCP Server | mcp |
| CLI Tool | cli |
| AI Coding Agent | agent |
| Agent Skill | skill |
| A2A Agent | a2a |
| AI Tool | tool |
Troubleshooting
- No matches: use fewer keywords or remove the category filter.
- Listing not found: copy the returned slug instead of guessing from a GitHub repository name.
- No setup excerpts: open the returned documentation or repository links; the README may use unsupported headings or be unavailable.
- HTTP 429: wait for the retry interval reported by the API, when supplied.
- Timeout: requests stop after 15 seconds and respect client cancellation. Retry later.
API and contributions
The MCP wraps the public A2ASearch REST API. Submit a listing, report an issue, or contribute improvements to setup extraction and client examples. Please include a public source and expected result for parser changes.
Development
npm ci --ignore-scripts
npm run check
npm test
npm pack --dry-run
# Optional: read-only smoke test against the live directory
npm run smoke:live
Tests exercise the MCP stdio handshake, output schemas, search → detail → setup, pagination, URL classification, setup extraction, missing information, argument validation, API failures, cancellation and both CLI entry points. Normal tests use fixtures and do not contact providers.
MIT licensed. See LICENSE.
A2ASearch MCP Fragen
Wie füge ich A2ASearch MCP zu Claude Code hinzu?
Führe claude mcp add a2asearch-mcp -- npx -y a2asearch-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich A2ASearch MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet A2ASearch MCP?
Er stellt 4 Tools bereit, darunter search_agents, get_agent, get_setup, list_agents.
Benötigt A2ASearch einen API-Key?
Nein. A2ASearch ist kostenlos abfragbar und benötigt keinen API-Key, obwohl die gelisteten Dienste eigene Zugangsdaten oder Zahlungen erfordern können.
Welche Tools bietet der A2ASearch MCP server?
Er bietet search_agents, get_agent, get_setup und list_agents, um Einträge zu finden und zu inspizieren.
Kann A2ASearch die gelisteten Tools installieren oder ausführen?
Nein. Er liest lediglich die A2ASearch API aus und gibt das Ausgangsmaterial zurück; er führt keinen Code aus, kontaktiert keine Anbieter und installiert keine Tools.
Wie erhalte ich Setup-Anleitungen für ein gelistetes Tool?
Rufe get_setup mit dem Slug auf, den du über search oder browse erhalten hast, um Auszüge aus dem Setup, JSON Config-Beispiele und die nächsten Schritte zu erhalten.
Welche Node.js Version benötigt a2asearch-mcp?
Es wird Node.js 22 oder neuer benötigt, wobei die CI-Testversionen 22 und 24 verwendet werden.