GRACE Hello MCP

GRACE Hello MCP

Render にデプロイできる、MCP 仕様（改訂版 2025-11-25、SEP-973）に準拠したカスタムアイコンを公開する、とてもシンプルなリモート MCP サーバー（Streamable HTTP トランスポート）です。

say_hello ツールを 1 つ公開し、initialize レスポンスの serverInfo.icons で告知されるカスタム PNG アイコンを提供します。

プロジェクト構成

ファイル	目的
server.js	MCP サーバー（Express + @modelcontextprotocol/sdk、Streamable HTTP）。
make_icon.py	static/icon.png を生成します（標準ライブラリのみで、依存関係はありません）。編集するとアイコンを変更できます。
static/icon.png	告知・提供されるアイコンです。
render.yaml	ワンクリックデプロイ用の Render ブループリントです。

ローカルで実行する

npm install
npm start            # serves on http://localhost:3000

• ランディング／ヘルスページ（アイコンが表示されます）：http://localhost:3000/
• MCP エンドポイント：http://localhost:3000/mcp
• アイコン：http://localhost:3000/icon.png

簡単な動作確認：

curl -s -X POST http://localhost:3000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

レスポンスに serverInfo.icons が表示されます。

または、公式のMCP Inspectorを使用してください（アイコンが表示されます）。

npx @modelcontextprotocol/inspector
# then connect to http://localhost:3000/mcp  (Streamable HTTP)

Render にデプロイする

1. このフォルダーを GitHub リポジトリにプッシュします。
2. Render で New ➜ Blueprint を選択し、リポジトリを指定します。render.yaml が読み込まれ、無料の Node ウェブサービスが作成されます。（または、New ➜ Web Service を選択して手動で設定し、ビルドコマンドに npm install、起動コマンドに npm start を指定します。）
3. Render が RENDER_EXTERNAL_URL を自動的に設定するため、server.js が適切な絶対 URL https://<your-service>.onrender.com/icon.png をアイコン URL として構築します。環境変数を手動で設定する必要はありません。
4. MCP エンドポイントは https://<your-service>.onrender.com/mcp です。

注：Render の無料プランはアイドル時にスリープするため、しばらく時間が経ってからの最初のリクエストでは、起動まで約 30 秒かかる場合があります。

MCP クライアントに追加する

Claude Code（CLI）：

claude mcp add --transport http grace-hello https://<your-service>.onrender.com/mcp

セッション内で /mcp を実行して確認し、Claude に「say_hello を使って Rajith に挨拶して」と依頼します。

Claude Desktop／その他の GUI クライアント： https://<your-service>.onrender.com/mcp を指定するリモート／HTTP MCP サーバーを追加します。

アイコンについて（お読みください）

このサーバーは、MCP 仕様に正しく準拠してアイコンを告知します。icons 配列は serverInfo（およびツール）に含まれます。アイコンの URI は https:// または data: である必要があります。このサーバーでは、ホストされた https://.../icon.png を使用します。

アイコンが表示されるかどうかは、クライアントによって異なります。 アイコン表示は比較的新しい機能で、対応状況にはばらつきがあります。

• ✅ MCP Inspector や、仕様に対応したその他のクライアントはアイコンを読み込み、表示します。
• ⚠️ Claude Code／Claude Desktop は現在、任意のサードパーティ製サーバーに対しては、引き続きデフォルトのプレースホルダーを表示します。Claude のマーケットプレイスに表示されるブランドアイコンは、Anthropic 側で設定されたファーストパーティ統合用のものです。クライアントのアイコン対応が進めば、このサーバーはすでに仕様に準拠しているため、変更なしで「そのまま動作」します。

カスタマイズ

• アイコン： make_icon.py の色や図形を編集し、npm run make-icon を実行します（static/icon.png が再生成されます）。または、独自の 512×512 PNG を static/icon.png に配置します。
• ツール： server.js に setRequestHandler のケースやツール定義を追加します。