代理构建模板

# 1. Clone this template
git clone https://github.com/Bheem-Platform/bheem-mcp-sdk.git my-module-mcp
cd my-module-mcp

# 2. Configure
cp .env.example .env
# → set MCP_PORT, MCP_EXTERNAL_URL, BACKEND_API_URL, ORCHESTRATOR_URL

# 3. Install & run
npm install
npm run dev

# 4. Verify
curl http://<YOUR_SERVER_IP>:9012/health

┌────────────────────────────────────────────────────────────┐
│              Your MCP Server (:9012)                        │
│                                                             │
│  Domain Tools (3-5)     Memory Tools (4)    Remote Ops (6) │
│  ┌────────────────┐    ┌──────────────┐    ┌─────────────┐ │
│  │ items           │    │ memory_set    │    │ remote_exec │ │
│  │ analytics       │    │ memory_get    │    │ remote_read │ │
│  │ [your domain]   │    │ memory_list   │    │ remote_write│ │
│  │                 │    │ memory_delete │    │ remote_edit │ │
│  └────────────────┘    └──────────────┘    │ remote_ls   │ │
│                              │              │ remote_health│ │
│                         ┌────┴────┐        └──────┬──────┘ │
│                         │ Cache + │              SSH│        │
│                         │ Postgres│                │        │
│                         └─────────┘         ┌──────┴──────┐ │
│                                             │ 9 Servers   │ │
│  Agent Templates (auto-register on boot)    │ Access Ctrl │ │
│  ┌───────────────────────────────────────┐  └─────────────┘ │
│  │ my-module-assistant  (SDK, free)       │                  │
│  │ my-module-deep-agent (PEV, pro)        │                  │
│  │ devops-engineer      (SDK, pro)        │                  │
│  └───────────────────────────────────────┘                  │
└────────────────────────────────────────────────────────────┘
         │                              │
    auto-register                  MCP calls
         ▼                              ▼
  Bheem Orchestrator            Any Bheem Agent

// src/tools/orders.ts — ONE tool, multiple actions
export const orderTools: McpToolDefinition[] = [{
  name: 'orders',
  description: `Order management. Actions: list, get, create, cancel, refund`,
  inputSchema: {
    type: 'object',
    properties: {
      action: { type: 'string', enum: ['list', 'get', 'create', 'cancel', 'refund'] },
      params: { type: 'object' },
    },
    required: ['action'],
  },
  execute: async (input, context) => {
    const scope = getUserScope(context);
    // ... switch on input.action
  },
}];

// src/templates/index.ts
{
  id: 'order-assistant',
  name: 'Order Assistant',
  orchestrator: 'sdk',
  model: 'auto',
  mcpServers: { orders: { type: 'http', url: MCP_URL } },
  allowedTools: [],
  skills: ['slack', 'trello'],
  systemPrompt: `You are an order management assistant.
## Tools
- orders({ action: 'list' }) — List orders
- memory_set({ key: 'x', value: 'y' }) — Store a fact
NEVER use curl or raw HTTP calls.`,
}

npm run build
pm2 start dist/index.js --name my-module-mcp
# Templates auto-register. Agent is immediately available.

src/
├── index.ts                    # Server + memory + remote ops + template registration
├── tools/
│   ├── items.ts                # Domain tool (example)
│   ├── analytics.ts            # Domain tool (example)
│   └── remote-ops.ts           # Remote server operations (6 tools, SSH, access control)
├── memory/
│   ├── index.ts                # Barrel exports
│   ├── workspace-memory-store.ts  # Cache + PostgreSQL write-through
│   ├── memory-tools.ts         # 4 MCP tools (set/get/list/delete)
│   ├── schema.ts               # TypeScript types
│   └── schema.sql              # PostgreSQL migration
├── templates/
│   └── index.ts                # Agent templates with skills (auto-register on boot)
└── utils/
    ├── api-client.ts           # Axios client for your backend
    └── scope.ts                # Auth helpers (role, userId, module, templateId)