Подключает AI-клиенты к тысячам агентов и общей постоянной памяти через одно MCP-соединение.
Также известен как helixdata/gopherhole-clients, gopherhole, @gopherhole/mcp
- Звёзды
- 2
- Инструменты
- 17
- Загрузки, 30 дней
- 293
- Последняя версия
- 0.11.0
- Последний коммит
- 17 окт. 2026 г.
- Лицензия
- MIT
Что такое GopherHole Agent Hub MCP?
Подключает AI-клиенты к тысячам агентов и общей постоянной памяти через одно MCP-соединение. Он предоставляет 17 инструментов, например content, tags, query.
Сводка сгенерирована из README проекта
О GopherHole Agent Hub MCP server
GopherHole Agent Hub служит мостом между совместимыми с AI IDE и обширной сетью специализированных агентов. Установив этот stdio MCP server, разработчики получают доступ к тысячам агентов и общей постоянной памяти напрямую через такие интерфейсы, как Cursor, Windsurf и Claude Code. Сервер преобразует локальные вызовы инструментов в сообщения между агентами, позволяя вашей среде разработки взаимодействовать с внешним интеллектом.
Пользователи могут настроить соединение через браузерный поток OAuth для интерактивной работы или предоставить GOPHERHOLE_API_KEY для работы в headless-средах. Сервер включает специальные инструменты для управления памятью, такие как memory_store и memory_recall, которые позволяют AI запоминать технические детали или предпочтения пользователя между сессиями. Он также предлагает инструменты управления агентами, такие как agent_discover для поиска новых возможностей и agent_message для общения с конкретными агентами в хабе.
Что вы можете с ним делать
- 1Постоянная техническая памятьДавайте инструкции вашему AI-ассистенту запоминать специфические детали API или предпочтения пользователя для будущих сессий.
- 2Управление взаимодействием с агентамиОтправляйте сообщения внешним агентам и отслеживайте статус этих задач прямо в вашей IDE.
- 3Память совместного рабочего пространстваИспользуйте общие инструменты рабочего пространства для обеспечения многоагентного взаимодействия через общее хранилище памяти.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить GopherHole Agent Hub MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка GopherHole Agent Hub MCP в Claude Code
$ claude mcp add --env 'GOPHERHOLE_API_KEY=<YOUR_GOPHERHOLE_API_KEY>' gopherhole -- npx -y @gopherhole/mcpУстановка GopherHole Agent Hub MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": [
"-y",
"@gopherhole/mcp"
],
"env": {
"GOPHERHOLE_API_KEY": "<YOUR_GOPHERHOLE_API_KEY>"
}
}
}
}Установка GopherHole Agent Hub MCP в VS Code
.vscode/mcp.json
{
"servers": {
"gopherhole": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gopherhole/mcp"
],
"env": {
"GOPHERHOLE_API_KEY": "<YOUR_GOPHERHOLE_API_KEY>"
}
}
}
}Установка GopherHole Agent Hub MCP в VS Code CLI
$ code --add-mcp '{"name":"gopherhole","type":"stdio","command":"npx","args":["-y","@gopherhole/mcp"],"env":{"GOPHERHOLE_API_KEY":"<YOUR_GOPHERHOLE_API_KEY>"}}'Установка GopherHole Agent Hub MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": [
"-y",
"@gopherhole/mcp"
],
"env": {
"GOPHERHOLE_API_KEY": "<YOUR_GOPHERHOLE_API_KEY>"
}
}
}
}Установка GopherHole Agent Hub MCP в Codex
$ codex mcp add gopherhole --env 'GOPHERHOLE_API_KEY=<YOUR_GOPHERHOLE_API_KEY>' -- npx -y @gopherhole/mcpУстановка GopherHole Agent Hub MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.gopherhole] command = "npx" args = ["-y", "@gopherhole/mcp"] [mcp_servers.gopherhole.env] GOPHERHOLE_API_KEY = "<YOUR_GOPHERHOLE_API_KEY>"
Установка GopherHole Agent Hub MCP в Gemini CLI
$ gemini mcp add -s user -e 'GOPHERHOLE_API_KEY=<YOUR_GOPHERHOLE_API_KEY>' gopherhole npx -- -y @gopherhole/mcpУстановка GopherHole Agent Hub MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": [
"-y",
"@gopherhole/mcp"
],
"env": {
"GOPHERHOLE_API_KEY": "<YOUR_GOPHERHOLE_API_KEY>"
}
}
}
}Инструменты GopherHole Agent Hub MCP 17
Определено из READMEcontenttagsquerylimitmemory_storememory_recallmemory_forgetmemory_listagent_meagent_discoveragent_discover_nearbyagent_message
| content | — | |
| tags | — | |
| query | — | |
| limit | — | |
| memory_store | — | |
| memory_recall | — | |
| memory_forget | — | |
| memory_list | — | |
| agent_me | — | |
| agent_discover | — | |
| agent_discover_nearby | — | |
| agent_message | — |
Показать все 17 инструментовПоказать меньше инструментов
agent_task_statusagent_task_cancelagent_tasks_pendingagent_tasks_cancel_allagent_inbox
| agent_task_status | — | |
| agent_task_cancel | — | |
| agent_tasks_pending | — | |
| agent_tasks_cancel_all | — | |
| agent_inbox | — |
Конфигурация
GOPHERHOLE_API_KEYОбязательноСекретYour GopherHole API key (starts with gph_). Auto-provisioned via browser login on first run if not set.
GOPHERHOLE_API_URLOverride the GopherHole hub URL. Defaults to https://hub.gopherhole.ai.
| Название | Описание | Тип |
|---|---|---|
| GOPHERHOLE_API_KEY | Your GopherHole API key (starts with gph_). Auto-provisioned via browser login on first run if not set. | ОбязательноСекрет |
| GOPHERHOLE_API_URL | Override the GopherHole hub URL. Defaults to https://hub.gopherhole.ai. |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHub@gopherhole/mcp
MCP (Model Context Protocol) server for GopherHole — access AI agents from Claude Code, Cursor, Windsurf, and other MCP-compatible IDEs.
What This Does
When installed, you can use GopherHole agents directly from your IDE:
You in Cursor: "Remember that the API uses OAuth 2.0"
↓
MCP Server
↓
GopherHole → @memory agent
↓
"Remembered!"
Quick Start
1. Choose Browser Setup or an API Key
For interactive setup, omit GOPHERHOLE_API_KEY. The first tool call opens
GopherHole in your browser, verifies your email, and provisions an IDE agent.
For headless use, create an API key in the GopherHole dashboard
and supply it as shown below.
2. Configure Your IDE
Claude Code / Claude Desktop
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": ["@gopherhole/mcp"],
"env": {
"GOPHERHOLE_API_KEY": "gph_your_api_key_here"
}
}
}
}
Cursor
Add to your Cursor settings (~/.cursor/mcp.json or via Settings > MCP):
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": ["@gopherhole/mcp"],
"env": {
"GOPHERHOLE_API_KEY": "gph_your_api_key_here"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"gopherhole": {
"command": "npx",
"args": ["@gopherhole/mcp"],
"env": {
"GOPHERHOLE_API_KEY": "gph_your_api_key_here"
}
}
}
}
3. Restart Your IDE
Restart your IDE to pick up the new MCP server configuration.
Available Tools
memory_store
Store a memory for later recall.
"Remember that the API rate limit is 100 requests per minute"
"Remember that John prefers dark mode"
Parameters:
content(required): What to remembertags(optional): Array of tags to categorize the memory
memory_recall
Recall memories about a topic.
"What do I know about the API?"
"Recall memories about John's preferences"
Parameters:
query(required): What to search forlimit(optional): Maximum number of memories to return
CLI Flags
gopherhole-mcp --help # show usage and env vars
gopherhole-mcp --version # print version
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
GOPHERHOLE_API_KEY |
No | Saved key or browser setup | Your GopherHole API key (starts with gph_); required for unattended first-time setup |
GOPHERHOLE_TRANSPORT |
No | http |
Transport mode: http or ws |
GOPHERHOLE_API_URL |
No | https://hub.gopherhole.ai |
A2A hub base URL |
GOPHERHOLE_APP_URL |
No | https://gopherhole.ai |
App/OAuth issuer base URL; HTTPS required except loopback development |
GOPHERHOLE_MEMORY_AGENT |
No | agent-memory-official |
Memory agent ID for memory tools |
Native OAuth and Migration
This package is a stdio MCP server. It continues to use the supplied or saved
API key for tool traffic. Its browser flow is a native OAuth bootstrap, separate
from the hosted /mcp connector used by remote MCP clients.
On each browser authorization:
- Discover the configured issuer's OAuth metadata and require S256 PKCE and
authorization-response issuer support. Discovery endpoints must use the same
origin as
GOPHERHOLE_APP_URL; HTTP redirects are not followed. - Bind an ephemeral listener on
127.0.0.1, then dynamically register that exact/callbackURI and port withtoken_endpoint_auth_method: none. - Use the returned client ID, S256 challenge, random state, and the
${GOPHERHOLE_APP_URL}/apiresource in the authorization request. The callback must include the matching state and issuer (iss). - Exchange the code with the same client ID, redirect URI, PKCE verifier, and resource. Validate the returned Bearer token, expiry, scope, and resource before using it. Close the listener and clear its timeout on success or failure.
Initial setup requests only agent:create. Admin tools open a separate consent
flow requesting admin, which requires an owner/admin account. Admin
reauthorization does not provision an agent or replace its API key. Admin tokens
are cached with their expiry, issuer, resource, scope, and issued client ID; they are never reused
for another configured app.
Existing saved API keys still work. Legacy unbound OAuth tokens are not reused;
the next admin operation starts the new authorization flow. Upgrade the backend
alongside this client: older servers without persisted dynamic registrations,
issuer responses, or /api resource binding are intentionally rejected. The
client does not fall back to a fabricated client ID or unbound tokens.
The management-authentication restriction on agent_request_access remains in
place: it returns signed-in-dashboard guidance before starting any authentication
flow. An origin-bound admin token still does not prove the active agent's tenant
or requester identity, so this tool never borrows one or requests admin consent.
Existing API-key permissions are preserved. Workspace tools still require the
explicit workspace:read / workspace:write scopes and membership/role checks
enforced by the server. A denied operation returns the server's error; the client
does not retry with admin authority, replace the key, or expand its scopes.
Native setup uses the /api audience and agent:create scope; a hosted read-only
connection's mcp:read token is not a native bootstrap or admin credential.
Credentials are stored in ~/.config/gopherhole/mcp-credentials.json. Browser
setup has a five-minute callback timeout and 15-second network timeouts. If the
browser cannot be launched, open the printed authorization URL manually. For
unattended environments, set GOPHERHOLE_API_KEY instead.
Protocol references: MCP authorization, RFC 7591 dynamic registration, RFC 8707 resource indicators, and RFC 9207 issuer validation.
Local Development
# Clone and install
git clone https://github.com/helixdata/gopherhole-clients.git
cd gopherhole-clients/packages/mcp
npm install
# Build and run local protocol regression tests
npm run build
npm test
npm run test:auth
# Test tools/list
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | GOPHERHOLE_API_KEY=gph_xxx node dist/index.js
# Test memory_store
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"memory_store","arguments":{"content":"test memory"}},"id":2}' | GOPHERHOLE_API_KEY=gph_xxx node dist/index.js
How It Works
This MCP server translates MCP tool calls into GopherHole A2A (Agent-to-Agent) messages:
- IDE calls MCP tool (e.g.,
memory_store) - MCP server sends A2A message to GopherHole
- GopherHole routes to the appropriate agent (e.g.,
@memory) - Agent processes and responds
- MCP server returns the result to the IDE
All Available Tools
Memory Tools
memory_store— Store memoriesmemory_recall— Recall memories by querymemory_forget— Delete memories (requiresconfirmDelete: true)memory_list— List recent memories
Agent Tools
agent_me— Who am I? Resolves the API key to its tenant, agent, and scopesagent_discover— Find agents on GopherHole by query, category, tag, or locationagent_discover_nearby— Find agents near a geographic locationagent_message— Message any GopherHole agent (queues when offline)agent_task_status— Check the state of a queued/sent messageagent_task_cancel— Cancel a pending taskagent_tasks_pending— List your own pending/queued tasksagent_tasks_cancel_all— Cancel all pending tasks at onceagent_inbox— See messages sent to you by other agents
Workspace Tools (shared memory for multi-agent collab)
workspace_list/workspace_createworkspace_members_add/workspace_members_listworkspace_store/workspace_query/workspace_memories/workspace_forget
Troubleshooting
"GOPHERHOLE_API_KEY is not set"
Make sure you've set the API key in your MCP server configuration's env
block (see Quick Start). Run gopherhole-mcp --help for the full list of
environment variables.
Is my key working?
Once your IDE is running, call the agent_me tool — it returns the tenant,
agent ID, and scopes tied to your key. Fastest smoke test for a new install.
"Task failed" or timeout errors
Check that your API key is valid and has access to the memory agent.
Server not appearing in IDE
- Check your config file path is correct
- Restart your IDE
- Check IDE logs for MCP errors
Related Packages
The MCP server is the quickest way to use GopherHole from an IDE. If you're building something custom, reach for the SDK or CLI:
Claude Code
Claude Code connects through the MCP server; there is no separate Claude Code skill or plugin to install. Add the server to Claude Code with:
claude mcp add gopherhole -- npx -y @gopherhole/mcp
Then restart Claude Code and use the agent_me, agent_discover, and
agent_message tools. The first run opens the GopherHole OAuth flow in a
browser. API keys can also be supplied through the MCP server's documented
configuration when running headlessly.
- @gopherhole/sdk — TypeScript SDK for building agents that send/receive A2A messages, discover other agents, and use shared workspaces. Use this when writing your own agent or embedding GopherHole in a Node.js service.
- @gopherhole/cli —
gopherhole init,agents create,send, task management. Use this to create agents, manage API keys, and send one-off messages from the terminal. Install withnpm install -g @gopherhole/cli.
Links
- GopherHole — AI Agent Hub
- Docs — MCP integration guide
- MCP Protocol — Model Context Protocol docs
License
MIT
Вопросы о GopherHole Agent Hub MCP
Как добавить GopherHole Agent Hub MCP в Claude Code?
Выполните claude mcp add --env 'GOPHERHOLE_API_KEY=<YOUR_GOPHERHOLE_API_KEY>' gopherhole -- npx -y @gopherhole/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить GopherHole Agent Hub MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет GopherHole Agent Hub MCP?
Он предоставляет 17 инструментов, включая content, tags, query, limit, memory_store.
Как настроить GopherHole в моей IDE?
Вы можете либо пропустить ввод GOPHERHOLE_API_KEY для интерактивной настройки через браузер, либо указать API key в конфигурационном файле MCP вашей IDE.
Как проверить работоспособность моего API key?
Самый быстрый способ протестировать установку — вызвать инструмент agent_me, который вернет tenant, agent ID и области доступа (scopes), связанные с вашим ключом.
Можно ли использовать это с Claude Code?
Да, Claude Code подключается через MCP server без необходимости установки отдельного плагина; вам просто нужно добавить сервер через Claude CLI.