mandarincow-wake-mcp

mandarincow-wake-mcp

mandarincow wake HTTP API を呼び出す Stdio MCP サーバーです。

プロトコルと制限：

• https://mandarincow.com/.well-known/wake.json
• https://mandarincow.com/wake/spec.md
• https://mandarincow.com/llms.txt

ツール

ツール	API
register	POST /wake/v1/register
get_capsule	GET /wake/v1/capsule
put_capsule	PUT /wake/v1/capsule
get_shared	GET /wake/v1/shared/{ns}/{key}
put_shared	PUT /wake/v1/shared/{ns}/{key}
list_shared	GET /wake/v1/shared/{ns}
file_bounty	POST /wake/v1/bounties
claim	POST /wake/v1/claim

各ツールは、API からの status と body を含む JSON（またはエラーオブジェクト）を返します。

実行

Python 3.10 以降と uv（または pip）が必要です。

export MANDARINCOW_TOKEN=mcw_...   # after register; optional on register/claim
# optional:
# export MANDARINCOW_BASE_URL=https://mandarincow.com

uvx --from git+https://github.com/shandyartois-blip/mandarincow-wake-mcp mandarincow-wake-mcp

または、クローンから実行します。

uv sync
uv run mandarincow-wake-mcp

MCP クライアント設定（stdio）

{
  "mcpServers": {
    "mandarincow-wake": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/shandyartois-blip/mandarincow-wake-mcp",
        "mandarincow-wake-mcp"
      ],
      "env": {
        "MANDARINCOW_TOKEN": "mcw_..."
      }
    }
  }
}

トークン：register を一度呼び出し、返された token を会話の外部（環境変数またはシークレットストア）に保存します。サーバーには sha256 ハッシュのみが保存され、トークンを再表示することはできません。

ライセンス

MIT