canonical-vault-mcp-server

Read-only MCP-сервер, который открывает GitHub-репозиторий canonical-vault для любого MCP-клиента — GitHub Copilot, Claude или чего угодно ещё, что говорит по Streamable HTTP MCP.

Пять инструментов, все только на чтение, все ограничены kushkillerjsixx66/canonical-vault:

В этом сервере намеренно нет инструментов записи — ничто здесь не может коммитить, пушить или изменять хранилище.

1. Развёртывание на Vercel

npm install -g vercel   # if you don't have it
cd canonical-vault-mcp-server
vercel login
vercel

Примите значения по умолчанию (Vercel автоматически определит api/mcp.ts как серверную функцию Node.js). После vercel --prod вы получите URL вида:

https://canonical-vault-mcp-server.vercel.app

Ваша MCP-конечная точка:

https://canonical-vault-mcp-server.vercel.app/api/mcp

Переменные окружения (задаются в дашборде Vercel → Settings → Environment Variables)

После добавления переменных окружения выполните повторный деплой (vercel --prod), чтобы функция их подхватила.

Related MCP server: github-mcp-tool

2. Подключение GitHub Copilot

Copilot (в VS Code и Copilot coding agent) читает конфигурацию MCP-сервера из .vscode/mcp.json в вашем рабочем пространстве или из глобальных настроек MCP в VS Code. Добавьте:

{
  "servers": {
    "canonical-vault": {
      "type": "http",
      "url": "https://canonical-vault-mcp-server.vercel.app/api/mcp"
    }
  }
}

Затем в VS Code: Command Palette → "MCP: List Servers" → canonical-vault → Start. Copilot Chat автоматически подхватит пять инструментов vault_* и сможет вызывать их в режиме агента.

Что касается удалённого кодирующего агента Copilot (не локального для VS Code), тот же URL можно зарегистрировать в настройках MCP-сервера вашей организации на github.com, где бы ни находился конфиг агента Copilot для вашего тарифа — это уже на стороне GitHub, а не этого сервера.

3. Локальное тестирование (до развёртывания)

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

Это откроет интерфейс MCP Inspector, где можно вручную вызывать каждый инструмент против живого репозитория перед подключением Copilot.

Чтобы протестировать HTTP-путь локально вместо stdio:

npm install -g vercel
vercel dev
# endpoint: http://localhost:3000/api/mcp

Примечания по архитектурным решениям

• Stateless-транспорт на каждый запрос: api/mcp.ts создаёт новый McpServer + StreamableHTTPServerTransport при каждом POST-запросе. Это правильный паттерн для serverless — функции Vercel не сохраняют память между вызовами, поэтому сессию хранить не нужно, и это предотвращает коллизии идентификаторов запросов, если два вызывающих обратятся к конечной точке одновременно.

• Родословная = история коммитов, а не отдельная концепция — vault_get_file_history — это буквально GET /commits?path=..., что является наиболее честным отображением «родословной» на то, что реально предлагает GitHub API. Если ваша концепция цепочки родословной хранилища (конвейер governance/vault) требует чего-то более специфичного — например, чтения манифеста родословной, который лежит в репозитории, — лучше навести vault_get_file на этот манифест напрямую, чем переписывать историю git.

• Только чтение по вашему решению — этот сервер не может писать в canonical-vault. Если позже вы захотите, чтобы Copilot коммитил обратно (например, через PR), это отдельный набор инструментов записи с нормальным ревью опасных действий, а не то, что стоит тихо прикручивать.

• Ограничение поиска: API поиска кода GitHub индексирует только ветку по умолчанию и имеет собственную задержку распространения — файл, закоммиченный несколько секунд назад, может ещё не появиться в vault_search_files. vault_get_file и vault_list_directory всегда отражают актуальное дерево.