Kwork MCP server
io.github.simonether/kwork-mcp·v1.5.2·3 starsAccount-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace
not scanned yet
3 stars
Reviews
Write oneNobody has reviewed Kwork yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Kwork tools
No tool declarations could be read from the package source. They show once the server is installed.
How Kwork compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- GitHub stars
- 3
- more than 80% of 28,688 servers
Release history: 7 versions in the registry since 2026-07-09, latest 2026-10-03, typically one every 3 days.
Install Kwork in Claude Code, Cursor or VS Code
claude mcp add kwork-mcp -- uvx kwork-mcp
What the publisher says
From the Kwork repository's README, as published. We do not edit it. Read it on GitHub
kwork-mcp 1.0 — production-grade stdio MCP-шлюз к Kwork для Claude Code, Claude Desktop, Codex, Cursor и других MCP-клиентов. Он даёт типизированные read-результаты, проверяет фактический аккаунт, координирует лимиты между процессами и проводит все записи через durable prepare → commit → reconcile.
Это breaking redesign. Для миграции с 0.2.x см. руководство по миграции.
Что гарантирует шлюз
сохраняет краткое резюме и JSON-копию результата.
- structuredContent соответствует объявленному outputSchema; текстовый content
возвращаются с isError=true и стабильным кодом.
- Read-операции различают knowndata, knownempty и unknown_error; ошибки
аккаунт. Без KWORKENABLEWRITES=true запись невозможна.
- Перед каждым write заново проверяются KWORKEXPECTEDUSER_ID и фактический
общем SQLite ledger. Одну операцию выполняет только один процесс.
- Точный payload, его SHA-256, TTL, confirmation token и idempotency key связаны в
submissionunknown требует reconcilewrite. Пропавший объект или неизвестный статус не считаются доказательством; если сверка не сходится, оператор фиксирует исход вручную через kwork-mcp-bootstrap resolve-write.
- Неоднозначный результат записи не повторяется автоматически: состояние
использующих один KWORKSTATEDIR; fingerprint общей policy не позволяет процессу с другими лимитами ослабить координацию.
- Лимиты account/route, защита от burst и circuit breaker общие для всех процессов,
старте и contract-тестами.
- kwork==0.2.0 закреплён; сигнатуры и generic routes проверяются fail-loud при
flock, проверкой всей ancestor chain, O_NOFOLLOW/FD-anchored traversal и atomic replace. Runtime-discovered credentials динамически редактируются в логах и внешних данных.
- Token и optional proxy сохраняются в account-scoped файлах с 0700/0600,
external_untrusted и не являются инструкциями для агента.
- Тексты проектов, профилей, сообщений и уведомлений помечаются
Установка
Требуются Python 3.12–3.14 и uv.
uvx --from kwork-mcp==1.0.0 kwork-mcp-bootstrap --helpИз исходников:
git clone https://github.com/simonether/kwork-mcp.git
cd kwork-mcp
uv sync --locked --dev
uv run kwork-mcp-bootstrap --helpkwork-mcp использует только stdio. Все его логи идут в stderr; stdout зарезервирован для MCP JSON-RPC. kwork-mcp-bootstrap — отдельная human CLI и не является MCP transport.
Безопасная конфигурация
Обычный сервер работает без login/password/token/proxy в конфигурации host. Единственный поддерживаемый production flow:
- Узнайте стабильный numeric user_id своего аккаунта из настроек/профиля Kwork.
- Один раз запустите bootstrap из настоящего terminal TTY:
KWORK_EXPECTED_USER_ID=123456 \
uvx --from kwork-mcp==1.0.0 kwork-mcp-bootstrapCLI скрыто запросит login/password, optional phone digits и optional proxy URL, вызовет только auth + getme, сверит точный userid и атомарно запишет account-bound credential record. Если существует legacy ~/.kwork_token, CLI предложит явный validated import: только regular file текущего владельца с mode 0600, без symlink. Legacy-файл после успешного импорта намеренно остаётся на месте, чтобы удаление было отдельным осознанным действием.
- Запускайте normal MCP только с безопасными steady-state ключами:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Kwork: common questions
- Is Kwork MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Kwork safety report
- How do I install Kwork?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Kwork need an API key?
- No secret keys are declared. It reads 25 settings from the environment.
- Is Kwork maintained?
- The last commit was 40 days ago (2026-09-25). The latest release is v1.5.2.
- How does Kwork compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); github stars 3 (more than 80% of 28,688 servers). Full comparison.