1. Conduid
  2. Communication
  3. Sharp Aircon MCP
MCP server · Communication

Sharp Aircon MCP

by · github.com/r1cA18/sharp-aircon-mcp
Unclaimed last commit 7 months ago comms
InstallView source
30Low

Scored 6 months ago · breakdown

About Sharp Aircon MCP

Sharp Aircon MCP is an MCP server published by r1cA18 in the Communication category.

The repository has 2 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/r1cA18/sharp-aircon-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

aircon_modeSet operation mode

Parameters not published.

aircon_plasmaclusterPlasmacluster on/off

Parameters not published.

aircon_powerTurn power on/off

Parameters not published.

aircon_statusGet current status

Parameters not published.

aircon_temperatureSet target temperature

Parameters not published.

aircon_windspeedSet wind speed

Parameters not published.

Ask AI

✦

Ask AI about Sharp Aircon MCP

Powered by Claude · Grounded in docs

I know everything about Sharp Aircon MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

Credits

License

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Sharp Aircon MCP

How do I install Sharp Aircon MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Sharp Aircon MCP safe to use with an AI agent?

Its trust score is 30 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Sharp Aircon MCP still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.