Mcp Dino

io.github.shennawardana23由 GitHub 账号 shennawardana23 发布v0.1.0更新于 Nov 3, 2026

MCP server with an interactive dinosaur dashboard (MCP Apps UI). No API keys required.

发布方自己的服务：dino.markets

已验证STDIO仅桌面开发者工具AI 与机器学习

概览

AI 生成的概览

一个用 Go 编写的参考型 MCP 服务器，为助手提供三个恐龙工具，其中包括以 MCP App 形式渲染的交互式 HTML 仪表板。

可以做什么
  • 获取一条随机恐龙知识及对应物种名称
  • 提出恐龙相关问题，返回一段通用的恐龙时代概述
  • 以 HTML 卡片网格形式在客户端内渲染 12 种恐龙的交互式仪表板，可按食性和时期筛选
  • 通过 HTTP 提供同一仪表板和 JSON 恐龙数据接口，便于浏览器直接访问
适用场景
适合作为学习 MCP Apps 协议和 Go/Gin MCP 服务器结构的示例项目，或在 Claude Desktop 中作为轻量的恐龙知识与仪表板小工具。不适合真实的科研或生产数据工作。
运行要求
以本地进程方式通过 stdio 运行；README 另提供监听 9010 端口的 HTTP 模式。已发布的包为 macOS arm64 构建。从源码构建需要 Go 1.25 或更高版本，以及用于构建界面的 Node.js 18 或更高版本；无需 API 密钥或环境变量。
安装前请注意
仪表板筛选在调用工具时由服务器端应用，因此界面内的按钮只能在初始结果集内进一步缩小范围。ask 工具无论问题为何都返回同一段概述。README 中的 tunnel 目标会通过公开的 Cloudflare 地址暴露本地服务器，使其可从本机之外访问。

安装

在 SourceWeft 中

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

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[dino-mcp]

A production-grade MCP server with interactive HTML dashboard UI — written in Go, styled for delight.

📋 Table of Contents

🦕 What — and Why

dino-mcp is a reference implementation of the Model Context Protocol (MCP) in Go that demonstrates every layer of the modern MCP stack:

LayerImplementationWhy it matters
Transportstdio + Streamable HTTPWorks in Claude Desktop AND web browsers
MCP Apps@modelcontextprotocol/ext-apps App classInteractive HTML UIs in Claude Desktop iframes
Toolsdino_think, dino_ask, dino_dashboardTyped Go handlers, structured JSON results
Resources//go:embed HTML → text/html;profile=mcp-appSelf-contained ~11MB binary, zero deps at runtime

Whether you're building an MCP server from scratch, learning the MCP Apps protocol, or need a Go — Gin — ext-apps SDK integration blueprint, this project has you covered.

⚡ Quick Start

bash
# Clone & entergit clone https://github.com/shennawardana23/mcp-dino.git && cd mcp-dino
# Build & run in one shot (≈2 seconds)make build-fast && make dev-http
# Open the standalone dashboardopen http://localhost:9010/dashboard
Expected output — click to expand 
=== dino-mcp server ===Transport: httpListening on :9010
[GIN] 2026/06/21 - 12:30:00 | 200 | 4.2ms | ::1 | GET "/dashboard"[GIN] 2026/06/21 - 12:30:01 | 200 | 2.1ms | ::1 | GET "/api/dinosaurs"

🏗 Architecture at a Glance

mermaid
flowchart TB  subgraph CLI["CLI Layer"]    STDIO["stdio subcommand"]    HTTP["http subcommand"]  end
  subgraph SERVER["Server (internal/server/)"]    GIN["Gin Router :9010"]    MCPH["MCP StreamableHTTPHandler"]    CORS["CORS Middleware"]    TOOLS["Tools: think · ask · dashboard"]    RES["Resources: //go:embed HTML"]  end
  subgraph UI["View (ui/src/)"]    APP["ext-apps App class"]    POST["postMessage protocol"]  end
  subgraph FALLBACK["Standalone Fallback"]    DASH["/dashboard (HTML)"]    API["/api/dinosaurs (JSON)"]  end
  CLI --> GIN  GIN --> CORS  CORS --> MCPH  MCPH --> TOOLS  TOOLS --> RES  RES --> APP  APP --> POST  MCPH -.->|"MCP Apps"| APP  GIN -.->|"direct route"| DASH  GIN -.->|"direct route"| API
  style CLI fill:#1a1a2e,color:#e0e0e0,stroke:#2d2a44  style SERVER fill:#1a1a2e,color:#e0e0e0,stroke:#2d2a44  style UI fill:#1a1a2e,color:#e0e0e0,stroke:#2d2a44  style FALLBACK fill:#1a1a2e,color:#e0e0e0,stroke:#2d2a44  style STDIO fill:#2d2a44,color:#a78bfa  style HTTP fill:#2d2a44,color:#a78bfa  style GIN fill:#0099e5,color:#fff  style MCPH fill:#a78bfa,color:#fff  style TOOLS fill:#22c55e,color:#fff  style RES fill:#22c55e,color:#fff  style APP fill:#facc15,color:#000  style POST fill:#facc15,color:#000  style DASH fill:#f87171,color:#fff  style API fill:#f87171,color:#fff

Data flows through three pipes:

PipeProtocolClientUse case
MCP ToolsJSON-RPC over stdioClaude DesktopText tools (dino_think, dino_ask)
MCP AppsJSON-RPC over stdio + postMessageClaude Desktop iframeInteractive UI (dino_dashboard)
StandaloneHTTP GETBrowserDirect access (/dashboard, /api/dinosaurs)

✨ Features

MCP Standards Compliance
FeatureStatusNotes
Tools (tools/list, tools/call)✅ Complete3 typed tools with structured JSON responses
Resources (resources/list, resources/read)✅ Complete//go:embed HTML served at ui:// URIs
MCP Apps protocol✅ Complete_meta.ui.resourceUri + ui/initialize handshake
stdio transport✅Claude Desktop, Cursor, Copilot
Streamable HTTP✅MCP Inspector, curl, browser, tunnel
SSE transport❌ RemovedDeprecated in MCP spec v2025-11-25
Developer Experience
  • 3-second build cycle — make build-fast && make dev-http
  • 7 integration tests — make test exercises every protocol method
  • Interactive debugging — make test-inspector launches MCP Inspector
  • Remote testing — make run-tunnel creates a public trycloudflare.com URL
  • No API keys — all dinosaur data is built into the binary
  • Zero runtime deps — single static binary with embedded HTML
Interactive Dashboard

The dino_dashboard tool renders an HTML card grid inside Claude Desktop's iframe:

  • Filter by diet — Carnivore, Herbivore, or show All
  • Filter by period — Triassic, Jurassic, Cretaceous
  • 12 dinosaur species — from T-Rex to Velociraptor
  • Fallback mode — open directly at http://localhost:9010/dashboard

Note: the filter is applied server-side at the time the tool is called. Once opened with a specific filter, the in-app filter buttons can only narrow further within that same result set — they can't widen back out to species the initial call excluded.

The HTML view is built with the official @modelcontextprotocol/ext-apps SDK and communicates via JSON-RPC over postMessage.

🎮 Try It

In Claude Desktop

Show me the dinosaur dashboard with carnivores

→ Claude detects the MCP App → renders an iframe → you see filterable dinosaur cards

In your browser

bash
open http://localhost:9010/dashboard

→ Standalone HTML with all dinosaur data fetched from the built-in REST API

With MCP Inspector

bash
make test-inspector

→ Opens http://localhost:5173 → connects to http://localhost:9010/mcp

Via curl

bash
# Initializecurl -s -X POST http://localhost:9010/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \  | python3 -m json.tool
# List toolsSID="<session-id-from-above>"curl -s -X POST http://localhost:9010/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -H "Mcp-Session-Id: $SID" \  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \  | python3 -m json.tool
# Call dino_thinkcurl -s -X POST http://localhost:9010/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -H "Mcp-Session-Id: $SID" \  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dino_think","arguments":{}}}' \  | python3 -m json.tool

🔧 Tool Reference

ToolTypeInputOutputExample Prompt
dino_thinkText{}Random fact + species JSON"Tell me a dinosaur fact"
dino_askText{"question": "..."}Answer + question JSON"What did T-Rex eat?"
dino_dashboardMCP App{"filter": "Carnivore"}HTML iframe + JSON data"Show me carnivore dinosaurs"

dino_ask currently returns the same general dinosaur-era overview regardless of the question asked — it doesn't yet branch on the question text. Tracked as a known limitation.

Example dino_think response:

json
{  "content": [    { "type": "text", "text": "🦕 Did you know? The Velociraptor was only about the size of a turkey!" }  ],  "structuredContent": {    "fact": "The Velociraptor was only about the size of a turkey",    "species": "Velociraptor"  }}

Example dino_dashboard response:

json
{  "content": [    { "type": "text", "text": "Displaying dinosaur dashboard with 4 dinosaurs (filter: Carnivore)" }  ],  "structuredContent": {    "filter": "Carnivore",    "dinosaurs": [      {        "name": "Tyrannosaurus Rex",        "period": "Cretaceous",        "diet": "Carnivore",        "length": "40 ft (12 m)",        "weight": "9 tons (8,000 kg)",        "funFact": "T-Rex had the strongest bite of any land animal ever",        "imageStyle": "bg-red-900"      }    ],    "timestamp": "2026-06-21T12:00:00Z"  }}

💬 Claude Desktop Integration

CLI Mode (stdin/stdout)

Locate the binary and add to your claude_desktop_config.json:

json
{  "mcpServers": {    "dino-mcp": {      "command": "/absolute/path/to/mcp-dino/bin/dino-mcp",      "args": ["stdio"]    }  }}

After saving, restart Claude Desktop. You'll see hammer icons (🔨) on tools when chatting — click to invoke directly, or let Claude decide.

HTTP Mode (for debugging)

bash
make dev-http# Server starts on :9010

🛠 Development

Prerequisites

ToolVersionPurpose
Go≥ 1.25Server binary
Node.js≥ 18UI build (Vite)
cloudflaredanyTunnel for remote testing

Commands

bash
# Build — three optionsmake build            # Full: Vite UI + Go binarymake build-fast       # Quick: Go binary only (reuses existing UI)make build-ui         # Vite UI only
# Runmake dev-http         # HTTP mode with verbose loggingmake run-stdio        # stdio mode for Claude Desktopmake run-tunnel       # HTTP + Cloudflare Tunnel
# Test & verifymake test             # 7 integration tests — all must passmake test-inspector   # Launch MCP Inspector in browsermake lint             # go vet + go fmt
# Utilitymake help             # All targets with descriptionsmake clean            # Remove all build artifacts

Project Structure

mcp-dino/├── bin/                          # Go build output (~11MB static binary)├── cmd/dino-mcp/main.go          # CLI entry point (stdio | http | help)├── internal/│   ├── server/│   │   └── server.go             # Composition root: mcp.Server + Gin + CORS│   ├── tools/│   │   ├── tools.go              # Shared types, constants, helpers│   │   ├── think.go              # RegisterThink (dino_think tool)│   │   ├── ask.go                # RegisterAsk (dino_ask tool)│   │   └── dashboard.go          # RegisterDashboardTool + 12 dino species + REST API│   └── resources/│       ├── dashboard.go          # RegisterDashboardResource + //go:embed HTML│       └── dashboard_ui.html     # Vite-built HTML (354KB)├── ui/│   └── src/│       └── mcp-app.ts            # ext-apps App class + postMessage├── docs/                         # Diátaxis documentation (see below)├── test_mcp.sh                   # 7 integration tests├── AGENTS.md                     # AI agent instructions (canonical)├── ARCHITECTURE.md               # C4 diagrams + sequence flows├── TECH_DESIGN.md                # Interface contracts + data model├── Makefile                      # All targets├── go.mod + go.sum               # Go dependencies└── README.md                     # ← you are here

🗺 Documentation Map

dino-mcp uses the Diátaxis framework — four documentation modes, each serving a different need.

For this audienceStart hereAudience
👋 New to the projectQuick StartEveryone
🧑‍💻 Adding a toolYour First ToolDevelopers
🦕 Adding a dinosaurAdd a DinosaurContent editors
🧪 Testing with InspectorTest with InspectorQA / Developers
🔍 Reference neededCLI ReferenceOperators
🏗 Understanding designArchitectureArchitects
🤖 Implementing via AIAGENTS.mdAI coding agents
📚 Deep architectureARCHITECTURE.mdSenior engineers
📐 Technical specsTECH_DESIGN.mdImplementation teams
⏳ Development historyMEMORY.mdAll contributors
📋 RoadmapPLAN.mdStakeholders
⚖️ Design trade-offsDESIGN.mdArchitects
🎯 Skills referenceSKILL.mdDevelopers / AI agents
🤝 How to contributeCONTRIBUTOR.mdContributors
📜 Code of conductCODE_CONDUCT.mdCommunity
📄 ADRsdocs/adr/Decision historians
🤖 LLM full contextllms-full.txtAI agents (RAG)

📊 Project Status

MVP ── Production ── Enhanced UI ── Ecosystem ── Advanced  ●                    ○               ○             ○
PhaseStatusHighlights
MVP✅ Complete3 tools, MCP Apps UI, 7 tests, docs
Production🔄 In progressGo unit tests, CI, rate limiting, Docker
Enhanced UI📅 PlannedReal-time data, comparison, timeline
Ecosystem📅 PlannedHomebrew, GitHub releases, MCP Registry
Advanced💭 FutureStreaming tool inputs, WebSocket sync

Build Metrics

MetricValue
Binary size~11 MB (compressed)
Binary typeMach-O 64-bit arm64
Go version1.25
MCP SDK versionv1.7.0
Dependencies30+ Go modules (all indirect)
UI bundle354 KB embedded HTML (single-file Vite)
Test coverage7/7 integration tests passing (shell-based; no Go unit tests yet)

📖 Further Reading

ResourceLink
MCP Specificationspec.modelcontextprotocol.io
MCP Go SDKgithub.com/modelcontextprotocol/go-sdk
MCP Apps Protocolmodelcontextprotocol.io/docs/apps/overview
ext-apps SDKgithub.com/modelcontextprotocol/ext-apps
Gin Web Frameworkgithub.com/gin-gonic/gin
Go Programming Languagego.dev

Built with ❤️ using Go, Gin, MCP Go SDK, and @modelcontextprotocol/ext-apps

来源：README.md，提交 da34724

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

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

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

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

其他 Dino 集成

dino.markets

markets.dino官方发布者

远程 MCP 端点，让助手获取 Kalshi 与 Polymarket 在体育、加密、天气和经济领域的匹配预测市场数据。

Streamable HTTP可网页运行
金融尚未收录Oct 24, 2026