GRACE Hello MCP

io.github.rajitharul由 GitHub 账号 rajitharul 发布v1.0.0更新于 Oct 24, 2026

A very simple remote MCP server that greets you, with a custom icon.

已验证Streamable HTTP可网页运行开发者工具

概览

AI 生成的概览

一个极简的远程 MCP 服务器，只提供一个问候工具 say_hello，并按 MCP 规范声明自定义图标。

可以做什么
  • 问候：仅一个 say_hello 工具，返回问候语，可指定收件人姓名。
  • 服务器元数据：在 initialize 响应的 serverInfo.icons 及工具上声明自定义 PNG 图标。
  • 托管附带内容：在 MCP 端点之外还提供落地/健康检查页面和图标文件。
适用场景
适合作为把客户端连接到远程 Streamable HTTP MCP 服务器的冒烟测试或参考示例，或用于检验客户端如何渲染规范声明的服务器图标。除问候外没有实际功能。
运行要求
需要一个远程 Streamable HTTP 端点；未声明认证、环境变量或请求头。托管实例运行在 Render 免费套餐上，空闲会休眠，暂停后首次请求可能需要约 30 秒唤醒。
安装前请注意
图标是否显示取决于客户端：README 说明 Claude Code 与 Claude Desktop 目前对第三方服务器仍显示默认占位图标。免费托管实例空闲后响应可能较慢。不索取任何凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GRACE Hello MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.rajitharul%2Fgrace-hello-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "grace-hello": {
      "type": "http",
      "url": "https://grace-hello-mcp.onrender.com/mcp"
    }
  }
}

README

GRACE Hello MCP

A very simple remote MCP server (Streamable HTTP transport) that advertises a custom icon per the MCP spec (rev 2025-11-25, SEP-973), ready to deploy on Render.

It exposes one tool, say_hello, and serves a custom PNG icon that is advertised in the initialize response's serverInfo.icons.

Project layout

FilePurpose
server.jsThe MCP server (Express + @modelcontextprotocol/sdk, Streamable HTTP).
make_icon.pyGenerates static/icon.png (stdlib only, no deps). Edit to change the icon.
static/icon.pngThe icon that gets advertised + served.
render.yamlRender blueprint for one-click deploy.

Run locally

bash
npm installnpm start            # serves on http://localhost:3000

Quick smoke test:

bash
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"}}}'

You should see serverInfo.icons in the response.

Or use the official MCP Inspector (renders the icon):

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

Deploy on Render

  1. Push this folder to a GitHub repo.
  2. In Render: New ➜ Blueprint, point it at the repo. It reads render.yaml and creates a free Node web service. (Or New ➜ Web Service manually: build npm install, start npm start.)
  3. Render injects RENDER_EXTERNAL_URL automatically, so server.js builds the correct absolute https://<your-service>.onrender.com/icon.png icon URL — no manual env vars needed.
  4. Your MCP endpoint is https://<your-service>.onrender.com/mcp.

Note: Render's free plan sleeps on idle, so the first request after a while may take ~30s to wake.

Add it to an MCP client

Claude Code (CLI):

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

Then in a session: /mcp to see it, and ask Claude to "use say_hello to greet Rajith".

Claude Desktop / other GUI clients: add a remote/HTTP MCP server pointing at https://<your-service>.onrender.com/mcp.

About the icon (read this)

This server advertises its icon correctly per the MCP spec: the icons array appears on serverInfo (and on the tool). It must be an https:// or data: URI — we use the hosted https://.../icon.png.

Whether a client shows it is up to that client. Icon rendering is a newer, inconsistently-supported feature:

  • ✅ MCP Inspector and other spec-aware clients read and display it.
  • ⚠️ Claude Code / Claude Desktop currently still show their default placeholder for arbitrary third-party servers — the branded icons in Claude's marketplace are first-party integrations configured on Anthropic's side. As client icon support matures, this server is already compliant and will "just work" with no changes.

Customize

  • Icon: edit colors/shapes in make_icon.py, then npm run make-icon (regenerates static/icon.png). Or just drop your own 512×512 PNG at static/icon.png.
  • Tools: add more setRequestHandler cases / tool definitions in server.js.

来源：README.md，提交 c4ae4bf

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。