sharp-aircon-mcp

日本語 | English

Sharp COCORO AIR API + MCP Server.

Hono based REST API and MCP server for controlling Sharp air conditioners via cocoro-sdk.

Features

• REST API for aircon control (power, temperature, mode)
• MCP server (Streamable HTTP + stdio)
• Claude Code plugin with skill integration

Setup

1. Install dependencies

bun install

2. Get credentials

You need to capture API credentials from the COCORO AIR app using mitmproxy.

mitmproxy

iPhone setup:

1. Wi-Fi > Proxy > Manual (Mac IP:8080)
2. Open http://mitm.it in Safari, install certificate
3. Settings > General > About > Certificate Trust Settings > Enable
4. Open COCORO AIR app and login

Extract from mitmproxy:

• COCORO_APP_SECRET: from the login URL query parameter
• COCORO_TERMINAL_APP_ID: from the request body, the part after /key/

3. Configure

cp .env.example .env
# Edit .env with your credentials

4. Run

# Development (with watch)
bun run dev

# Production
bun run start

# Type check
bun run typecheck

REST API

Method	Path	Description	Body
GET	/	Health check	-
GET	/api/status	Get aircon status	-
POST	/api/power	Power on/off	{"on": true}
POST	/api/temperature	Set temperature (16-30, integer)	{"temperature": 22}
POST	/api/mode	Set operation mode	{"mode": "heat"}
POST	/api/windspeed	Set wind speed	{"level": "auto"}
POST	/api/plasmacluster	Plasmacluster on/off	{"on": true}

Available modes: auto, cool, heat, dry, fan Wind speed levels: auto, 1-8 (1=weakest, 8=strongest)

Example

# Get status
curl http://localhost:3000/api/status

# Turn on
curl -X POST http://localhost:3000/api/power \
  -H "Content-Type: application/json" \
  -d '{"on": true}'

# Set temperature
curl -X POST http://localhost:3000/api/temperature \
  -H "Content-Type: application/json" \
  -d '{"temperature": 22}'

# Set mode
curl -X POST http://localhost:3000/api/mode \
  -H "Content-Type: application/json" \
  -d '{"mode": "heat"}'

MCP Server

Two transport modes available:

Streamable HTTP

Endpoint: http://localhost:3000/mcp

claude mcp add sharp-aircon --transport http http://localhost:3000/mcp

Stdio (Claude Code plugin)

bun run src/stdio.ts

Tools

Tool	Description	Parameters
aircon_status	Get current status	-
aircon_power	Turn power on/off	on: boolean
aircon_temperature	Set target temperature	temperature: integer (16-30)
aircon_mode	Set operation mode	mode: "auto"|"cool"|"heat"|"dry"|"fan"
aircon_windspeed	Set wind speed	level: "auto"|"1"-"8"
aircon_plasmacluster	Plasmacluster on/off	on: boolean

Claude Code Plugin

This project is structured as a Claude Code plugin.

# Install from local path
claude plugin marketplace add /path/to/sharp_aircon_api

# Enable/disable
claude plugin enable sharp-aircon
claude plugin disable sharp-aircon

Plugin structure:

.claude-plugin/
  plugin.json          # Plugin metadata
  marketplace.json     # Marketplace registration
.mcp.json              # MCP server config (stdio)
skills/
  smart-aircon/
    SKILL.md           # Weather-based AC advisor
  aircon-scheduler/
    SKILL.md           # Cron-based AC automation
  aircon-scene/
    SKILL.md           # Preset scene management

Project Structure

src/
  index.ts           # Hono server entry point
  cocoro-client.ts   # cocoro-sdk wrapper
  stdio.ts           # Stdio MCP entry point
  api/
    routes.ts        # REST API routes
  mcp/
    server.ts        # MCP tool definitions

Tech Stack

• Bun - Runtime
• Hono - Web framework
• cocoro-sdk - Sharp COCORO API client
• @modelcontextprotocol/sdk - MCP SDK
• @hono/mcp - Hono MCP transport
• Zod v4 - Validation

Credits

• dvcrn/cocoro-sdk - Unofficial TypeScript SDK for the Sharp COCORO API by @dvcrn
• rcmdnk/cocoro - Python implementation of COCORO API tools

License

AGPL-3.0 (following cocoro-sdk's license)