Coze-Power: Bridge Coze Bots to Local Capabilities

Overview

Coze bots are powerful, but they live in the cloud. They can't read your local files, run terminal commands, or interact directly with your machine. Coze-Power solves this with a lightweight HTTP server that exposes local tools through a standard OpenAPI interface that Coze plugins can consume.

Architecture

Quick Start (5 minutes)

1. Start the server

cd coze-power
python3 server.py
# Server starts on http://localhost:8899

2. Expose it publicly (one of these)

# Using ngrok (recommended for beginners)
ngrok http 8899
# → https://xxxx.ngrok.io  (copy this URL)

# Or using Cloudflare Tunnel
cloudflared tunnel --url http://localhost:8899

3. Import the Coze plugin

1. In Coze Studio, go to Plugins → Create Plugin
2. Import from OpenAPI → Upload assets/openapi-spec.json
3. Set Server URL to your ngrok/cloudflare URL (e.g. https://xxxx.ngrok.io)
4. Add API key authentication: header name X-API-Key, value from your config.json
5. Save and enable the plugin
6. Add the plugin to your Coze bot

4. Test it

In your Coze bot, try:

"Search the web for latest AI news" "List files on my desktop" "Show me the current system status"

Available Tools

Configuration

Create config.json in the skill directory:

{
  "api_key": "your-secret-api-key",
  "host": "0.0.0.0",
  "port": 8899,
  "allowed_commands": ["ls", "pwd", "cat", "echo", "python3", "node"],
  "allowed_paths": ["/home", "/tmp"],
  "max_file_size_kb": 1024
}

Security

⚠️ You are exposing your local machine to the internet. Follow these rules:

• Always use API key authentication (never run without it)
• Use allowed_commands and allowed_paths to restrict access
• For production: add HTTPS via ngrok (it automatically provides TLS)
• Never expose this server without authentication
• Consider running it in a Docker container for isolation

Coze Plugin Setup (Detailed)

See references/coze-plugin-setup.md for step-by-step Coze configuration.

Examples

See references/examples.md for real Coze bot prompts and expected behaviors.

API Reference

See references/api-reference.md for complete endpoint documentation.