Initial commit: Product OS platform
- Control Plane API with Gemini integration - Executors: Deploy, Analytics, Marketing - MCP Adapter for Continue integration - VSCode/VSCodium extension - Tool registry and run tracking - In-memory storage for local dev - Terraform infrastructure setup
This commit is contained in:
103
platform/backend/mcp-adapter/README.md
Normal file
103
platform/backend/mcp-adapter/README.md
Normal file
@@ -0,0 +1,103 @@
|
||||
# Product OS MCP Adapter
|
||||
|
||||
Exposes Control Plane tools to Continue and other MCP clients.
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
Continue (MCP client)
|
||||
↓
|
||||
MCP Adapter (this server)
|
||||
↓
|
||||
Control Plane API
|
||||
↓
|
||||
Gemini + Executors
|
||||
```
|
||||
|
||||
## Available Tools
|
||||
|
||||
| Tool | Description |
|
||||
|------|-------------|
|
||||
| `deploy_service` | Deploy a Cloud Run service |
|
||||
| `get_service_status` | Check deployment health |
|
||||
| `get_funnel_analytics` | Get conversion metrics |
|
||||
| `get_top_drivers` | Understand metric drivers |
|
||||
| `generate_marketing_posts` | Create social content |
|
||||
| `chat_with_gemini` | General AI conversation |
|
||||
|
||||
## Setup
|
||||
|
||||
### 1. Install dependencies
|
||||
|
||||
```bash
|
||||
cd platform/backend/mcp-adapter
|
||||
npm install
|
||||
```
|
||||
|
||||
### 2. Make sure Control Plane is running
|
||||
|
||||
```bash
|
||||
cd platform/backend/control-plane
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 3. Install Continue Extension
|
||||
|
||||
In VS Code/VSCodium:
|
||||
1. Open Extensions (Cmd+Shift+X)
|
||||
2. Search for "Continue"
|
||||
3. Install
|
||||
|
||||
### 4. Configure Continue
|
||||
|
||||
The configuration is already in `.continue/config.yaml`.
|
||||
|
||||
Or manually add to your Continue config:
|
||||
|
||||
```yaml
|
||||
experimental:
|
||||
modelContextProtocolServers:
|
||||
- name: productos
|
||||
command: npx
|
||||
args:
|
||||
- tsx
|
||||
- /path/to/platform/backend/mcp-adapter/src/index.ts
|
||||
env:
|
||||
CONTROL_PLANE_URL: http://localhost:8080
|
||||
```
|
||||
|
||||
### 5. Use in Continue
|
||||
|
||||
1. Open Continue chat (Cmd+L)
|
||||
2. Enable Agent mode (click the robot icon)
|
||||
3. Ask: "Deploy my service to staging"
|
||||
|
||||
## Environment Variables
|
||||
|
||||
| Variable | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `CONTROL_PLANE_URL` | `http://localhost:8080` | Control Plane API URL |
|
||||
| `TENANT_ID` | `t_mcp` | Tenant ID for tool calls |
|
||||
|
||||
## Development
|
||||
|
||||
```bash
|
||||
# Run directly (for testing)
|
||||
npm run dev
|
||||
|
||||
# Build
|
||||
npm run build
|
||||
|
||||
# Run built version
|
||||
npm start
|
||||
```
|
||||
|
||||
## Testing
|
||||
|
||||
```bash
|
||||
# Test tool listing
|
||||
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npm run dev
|
||||
|
||||
# Test tool call
|
||||
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_funnel_analytics","arguments":{}}}' | npm run dev
|
||||
```
|
||||
Reference in New Issue
Block a user