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#

bash

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

2. Expose it publicly (one of these)#

bash

# 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#

ToolMethodEndpointDescriptionWeb SearchPOST/tools/web-searchSearch the web and return resultsRead FilePOST/tools/read-fileRead content from local filesWrite FilePOST/tools/write-fileWrite content to local filesList DirectoryPOST/tools/list-dirList files in a directoryRun CommandPOST/tools/run-commandExecute shell commandsSystem InfoPOST/tools/system-infoGet OS, CPU, memory infoRead ClipboardPOST/tools/clipboard-readRead clipboard contentsWrite ClipboardPOST/tools/clipboard-writeWrite to clipboardSend NotificationPOST/tools/notifySend desktop notificationHealth CheckGET/healthCheck server status

Configuration#

Create config.json in the skill directory:

json

{
  "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.