Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Olivier Chafik 50eb30ec8d Bump to 2.0.0 and widen SDK peer ranges to ^2.0.0 The client, core and server packages become ^2.0.0 peers and client is now a required peer (App and AppBridge extend its Protocol class); server stays optional for View-only consumers. Examples move to zod ^4.2.0 to match the library peer range. The root package is not yet published at 2.0.0, so the lockfile now links the examples' @modelcontextprotocol/ext-apps dependency to the repository root instead of a registry copy. This drops the stale 1.x tarball (and its sdk 1.x peer) from the lockfile and makes scripts/link-self.mjs a no-op.		2026-09-08 13:58:22 +01:00
..
src	refactor: finish MCP SDK v2 migration	2026-07-14 17:07:30 -07:00
.gitignore	Improve consistency and organization of examples for AI learning	2026-01-13 20:48:02 -06:00
grid-cell.png	feat(basic-host): URL params, fullscreen mode, unified layout (#266 )	2026-01-14 22:09:41 +00:00
main.ts	refactor: finish MCP SDK v2 migration	2026-07-14 17:07:30 -07:00
mcp-app.html	Add color-scheme meta tag to all example apps	2025-12-15 11:42:18 -08:00
package.json	Bump to 2.0.0 and widen SDK peer ranges to ^2.0.0	2026-09-08 13:58:22 +01:00
README.md	Use `apps.extensions.modelcontextprotocol.io` domain for docs URLs	2026-02-24 11:38:54 -06:00
screenshot.png	feat(basic-host): URL params, fullscreen mode, unified layout (#266 )	2026-01-14 22:09:41 +00:00
server.ts	refactor: finish MCP SDK v2 migration	2026-07-14 17:07:30 -07:00
tsconfig.json	Add wiki-explorer-server example (#122 )	2025-12-11 13:58:05 +01:00
tsconfig.server.json	feat: compile example servers to JavaScript for npm consumption (#259 )	2026-01-14 23:46:17 +00:00
vite.config.ts	Add wiki-explorer-server example (#122 )	2025-12-11 13:58:05 +01:00

README.md

Example: Wiki Explorer

Visualizes Wikipedia link graphs using a force-directed layout. Explore how Wikipedia pages are connected by expanding nodes to reveal first-degree links.

MCP Client Configuration

Add to your MCP client configuration (stdio transport):

{
  "mcpServers": {
    "wiki-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "--silent",
        "--registry=https://registry.npmjs.org/",
        "@modelcontextprotocol/server-wiki-explorer",
        "--stdio"
      ]
    }
  }
}

Local Development

To test local modifications, use this configuration (replace ~/code/ext-apps with your clone path):

{
  "mcpServers": {
    "wiki-explorer": {
      "command": "bash",
      "args": [
        "-c",
        "cd ~/code/ext-apps/examples/wiki-explorer-server && npm run build >&2 && node dist/index.js --stdio"
      ]
    }
  }
}

Features

Force-directed graph visualization: Interactive graph powered by force-graph
Node expansion: Click any node to expand and see all pages it links to
Visual state tracking: Nodes change color based on state (blue = default, green = expanded, red = error)
Direct page access: Open any Wikipedia page in your browser

Running

Install dependencies:
```
npm install
```

Build and start the server:

npm run start:http  # for Streamable HTTP transport
# OR
npm run start:stdio  # for stdio transport

View using the basic-host example or another MCP Apps-compatible host.

Tool Input

To test the example, call the get-first-degree-links tool with a Wikipedia URL:

{
  "url": "https://en.wikipedia.org/wiki/Graph_theory"
}

Click nodes in the graph to Open (view in browser) or Expand (visualize linked pages).

Architecture

Server (`server.ts`)

MCP server that fetches Wikipedia pages and extracts internal links.

Exposes one tool:

get-first-degree-links - Returns links to other Wikipedia pages from a given page

App (`src/mcp-app.ts`)

Vanilla TypeScript app using force-graph for visualization that:

Receives tool inputs via the MCP App SDK
Renders an interactive force-directed graph
Supports node expansion to explore link relationships