feat: v2 3-tier architecture (mcpctl → mcplocal → mcpd) #3

Merged

michal merged 1 commits from feat/v2-architecture into main 2026-02-22 11:44:03 +00:00

Conversation 0 Commits 1 Files Changed 82 +5832 -123

michal commented 2026-02-22 11:42:27 +00:00

Owner

Copy Link

Summary

• Rename local-proxy → mcplocal with Fastify HTTP server, LLM pre-processing pipeline, and mcpd server discovery
• LLM pipeline: token estimation (~4 chars/token), LRU filter cache with TTL, metrics tracking, Gemini CLI + DeepSeek API providers
• mcpd auth & proxy: login/logout endpoints, session-based auth, MCP proxy endpoint routing through managed servers
• CLI updates: dual URLs (mcplocalUrl/mcpdUrl), login/logout commands, --direct flag, backward-compat daemonUrl transform
• Tiered health monitoring: checks mcplocal, mcpd, and individual instances with /health/detailed endpoint
• Shell completions: bash and fish completions for mcpctl
• E2E integration tests: 23 tests covering full proxy flow, LLM filtering, discovery, auth, health

Architecture

Claude → mcplocal (port 3200, LLM filter) → mcpd (port 3100, instance mgmt) → MCP servers

Test plan

• 57 test files, 597 tests all passing
• TypeScript strict mode with exactOptionalPropertyTypes clean
• Full build passes across all workspace packages

🤖 Generated with Claude Code

## Summary - **Rename local-proxy → mcplocal** with Fastify HTTP server, LLM pre-processing pipeline, and mcpd server discovery - **LLM pipeline**: token estimation (~4 chars/token), LRU filter cache with TTL, metrics tracking, Gemini CLI + DeepSeek API providers - **mcpd auth & proxy**: login/logout endpoints, session-based auth, MCP proxy endpoint routing through managed servers - **CLI updates**: dual URLs (`mcplocalUrl`/`mcpdUrl`), `login`/`logout` commands, `--direct` flag, backward-compat `daemonUrl` transform - **Tiered health monitoring**: checks mcplocal, mcpd, and individual instances with `/health/detailed` endpoint - **Shell completions**: bash and fish completions for mcpctl - **E2E integration tests**: 23 tests covering full proxy flow, LLM filtering, discovery, auth, health ## Architecture ``` Claude → mcplocal (port 3200, LLM filter) → mcpd (port 3100, instance mgmt) → MCP servers ``` ## Test plan - [x] 57 test files, 597 tests all passing - [x] TypeScript strict mode with `exactOptionalPropertyTypes` clean - [x] Full build passes across all workspace packages 🤖 Generated with [Claude Code](https://claude.com/claude-code)

michal added 1 commit 2026-02-22 11:42:27 +00:00

feat: implement v2 3-tier architecture (mcpctl → mcplocal → mcpd) ... b8c5cf718a

- Rename local-proxy to mcplocal with HTTP server, LLM pipeline, mcpd discovery
- Add LLM pre-processing: token estimation, filter cache, metrics, Gemini CLI + DeepSeek providers
- Add mcpd auth (login/logout) and MCP proxy endpoints
- Update CLI: dual URLs (mcplocalUrl/mcpdUrl), auth commands, --direct flag
- Add tiered health monitoring, shell completions, e2e integration tests
- 57 test files, 597 tests passing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

michal merged commit 46e07e4515 into main 2026-02-22 11:44:03 +00:00

michal deleted branch feat/v2-architecture 2026-02-22 11:44:03 +00:00

michal referenced this issue from a commit 2026-02-22 11:44:04 +00:00

Merge pull request 'feat: v2 3-tier architecture (mcpctl → mcplocal → mcpd)' (#3) from feat/v2-architecture into main

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

michal

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: michal/mcpctl#3