Skip to content

Implement MCP HTTP transport (v0.1.0)#1

Open
Bleyle823 wants to merge 3 commits into
mainfrom
feat/mcp-transport-v0.1.0
Open

Implement MCP HTTP transport (v0.1.0)#1
Bleyle823 wants to merge 3 commits into
mainfrom
feat/mcp-transport-v0.1.0

Conversation

@Bleyle823
Copy link
Copy Markdown

@Bleyle823 Bleyle823 commented Jun 1, 2026

Summary

  • Implement the shared KeeperHub MCP HTTP kernel in both TypeScript (@keeperhub/mcp-client) and Python (keeperhub-mcp-client).
  • TypeScript: KeeperHubMcpClient with lazy session bootstrap, ools/call, automatic re-init on 401/404, API key resolution (KH_API_KEY / KEEPERHUB_API_KEY), and kh_ vs wfb_ key classification
  • Python: equivalent client using httpx (replaces scaffold mcp SDK dependency), plus matching key helpers
  • Add unit tests: 12 Vitest tests (TS) and 4 pytest tests (Python)
  • Bump both packages to 0.1.0 and update root/package READMEs for first publish
  • Remove unused @modelcontextprotocol/sdk dependency from TS package; use direct HTTP transport instead
  • Add prepublishOnly build hook for npm publish from packages/mcp-client

Test plan

  • pnpm --filter @keeperhub/mcp-client build succeeds
  • pnpm --filter @keeperhub/mcp-client test - 12 tests pass
  • python -m pytest python/tests/ - 4 tests pass
  • Maintainer bootstrap publish to npm (@keeperhub/mcp-client@0.1.0) - first publish must be manual before Trusted Publisher works
  • Tag
    pm-v0.1.0 to trigger release workflow after npm bootstrap
  • Tag py-v0.1.0 to trigger PyPI trusted publishing

Notes

  • Publish npm from packages/mcp-client/ only (not repo root)
  • Framework plugins (Eliza, OpenClaw, Hermes) remain in their respective ecosystems and will depend on these packages once published

Bleyle823 and others added 2 commits June 1, 2026 07:10
Port the shared KeeperHub MCP kernel from the plugins monorepo: session bootstrap, tools/call, 401/404 re-init, API key helpers, and unit tests. Bump both packages to 0.1.0 and update docs for first npm/PyPI release.

Co-authored-by: Cursor <cursoragent@cursor.com>
Run TS build/test/type-check and Python pytest on PRs and main. Add npm keywords and a root test:python script for local verification.

Co-authored-by: Cursor <cursoragent@cursor.com>
@Bleyle823
Copy link
Copy Markdown
Author

Bleyle823 commented Jun 1, 2026

For maintainers - post-merge release checklist

This PR implements v0.1.0 of both clients and is ready for review/merge. After merge:

npm (@keeperhub/mcp-client)

  1. Bootstrap publish manually once (Trusted Publisher requires an existing package):
    �ash cd packages/mcp-client npm run build npm publish
  2. On npmjs.com ? @keeperhub/mcp-client ? Settings ? Trusted Publisher ? GitHub Actions (KeeperHub/mcp-client, workflow
    elease-npm.yml)

CI

  • Added .github/workflows/ci.yml - runs TS build/test/type-check + Python pytest (3.9 & 3.12) on PRs and main

Verified locally

  • 12 Vitest tests pass
  • 4 pytest tests pass

Co-authored-by: Cursor <cursoragent@cursor.com>
@Bleyle823 Bleyle823 requested a review from eskp June 1, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant