60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
# Project TODO List
|
|
|
|
This document outlines the tasks to be completed for the `mcp-bridge` project.
|
|
|
|
## Phase 1: Core Functionality
|
|
|
|
- [ ] **Project Setup**
|
|
- [x] Initialize Git repository and connect to remote
|
|
- [x] Create directory structure (`/src`, `/test`, `/dist`)
|
|
- [x] Create placeholder `build-test-deploy.sh` and `install.sh`
|
|
- [ ] **Configuration Handling**
|
|
- [ ] Implement YAML parsing for `config.yaml`
|
|
- [ ] Implement loading of service-specific YAML files
|
|
- [ ] Finalize YAML structure (e.g., use a map for services, add `command` for adapter)
|
|
- [ ] **HTTP Server**
|
|
- [ ] Create basic HTTP server that binds to `localhost`
|
|
- [ ] Implement configurable port via command-line flag
|
|
- [ ] **MCP Adapter Management**
|
|
- [ ] Implement logic to spawn MCP adapters as child processes
|
|
- [ ] Manage the lifecycle of adapter processes (start, stop)
|
|
- [ ] **MCP Communication**
|
|
- [ ] Implement `stdio`-based communication with child processes
|
|
- [ ] Implement JSON-RPC 2.0 message serialization/deserialization
|
|
- [ ] **Request Routing**
|
|
- [ ] Implement handler to parse `?service=` query parameter
|
|
- [ ] Route incoming HTTP requests to the correct MCP service based on the query param
|
|
- [ ] Handle default service logic when the query param is omitted
|
|
|
|
## Phase 2: Features & Refinements
|
|
|
|
- [ ] **Session Management**
|
|
- [ ] Implement transparent MCP session handling (initialize and store `sessionId` internally)
|
|
- [ ] **Endpoint Mapping**
|
|
- [ ] Map HTTP POST requests to the `tools/call` MCP method
|
|
- [ ] Pass request body as parameters to the MCP call
|
|
- [ ] **Error Handling**
|
|
- [ ] Translate MCP errors to appropriate HTTP status codes (400, 500)
|
|
- [ ] Implement graceful handling for config errors, missing services, etc.
|
|
- [ ] **Logging**
|
|
- [ ] Add structured logging for requests, responses, and errors
|
|
- [ ] Implement configurable verbosity via a command-line flag (e.g., `-v`)
|
|
- [ ] **Configuration Reload**
|
|
- [ ] Implement dynamic config reload via `SIGHUP` signal
|
|
- [ ] Implement `/reload` HTTP endpoint
|
|
- [ ] Define and implement session/process behavior on reload
|
|
|
|
## Phase 3: Testing & Distribution
|
|
|
|
- [ ] **Build & Installation Scripts**
|
|
- [ ] Populate `build-test-deploy.sh` to compile for multiple architectures (macOS, Linux, Windows) and place binaries in `./dist`
|
|
- [ ] Populate `install.sh` to download and install the correct binary for the user's system
|
|
- [ ] **Testing**
|
|
- [ ] Create basic unit tests for HTTP handling and request routing in `/test`
|
|
- [ ] Create integration tests for MCP communication
|
|
- [ ] **Documentation**
|
|
- [ ] Create `README.md` with comprehensive installation, configuration, and usage instructions
|
|
- [ ] Provide sample `config.yaml` and `service1.yaml` files
|
|
- [ ] **Finalization**
|
|
- [ ] Commit compiled binaries to the `./dist` directory
|
|
- [ ] Tag a version `v1.0.0` |