mcp-app
Provides tools to list GitHub repositories, fetch user profiles, and list repository issues using the GitHub REST API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-applist repos for user torvalds with cards layout"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GitHub MCP App Demo (json-render + LLM)
An MCP App that fetches public GitHub repositories and uses an LLM to generate a json-render UI spec.
Project layout
mcp-app/
├── server/ # MCP server (tools, GitHub API, LLM spec generation)
│ ├── main.ts # entry — HTTP / stdio transport
│ ├── server.ts # tool + resource registration
│ ├── github.ts # GitHub REST API
│ ├── llm-spec.ts # DeepSeek / OpenAI → json-render spec
│ ├── catalog.ts # json-render component catalog
│ └── types.ts
├── app/ # MCP App UI (iframe)
│ ├── index.html
│ ├── main.tsx
│ └── registry.tsx
├── dist/ # build output (index.html bundle)
└── .envRelated MCP server: github-portfolio
Flow
GitHub API → repos data → LLM + catalog.prompt() → json-render Spec → RendererSetup
npm install
cp .env.example .env
# Set DEEPSEEK_API_KEY and DEEPSEEK_MODEL in .env
npm run build
npm startServer listens at http://localhost:3001/mcp.
Test with basic-host
cd /Users/CYKUO/Codes/ext-apps/examples/basic-host && npm startOpen http://localhost:8080 → http://localhost:3001/mcp → pick a tool → Call Tool.
Tools
All tools require DEEPSEEK_API_KEY and use the LLM to generate the UI spec. The layout parameter (table or cards) is passed as a hint to the LLM.
list-repos
Parameter | Description |
| GitHub user (default: |
| Max repos to fetch (default: 10) |
|
|
| Natural language UI instructions for the LLM |
get-user-profile
Parameter | Description |
| GitHub user (default: |
|
|
| Natural language UI instructions for the LLM |
Returns profile fields such as bio, followers, following, public repo count, location, and company.
list-repo-issues
Parameter | Description |
| Repo owner (default: |
| Repo name (default: |
|
|
| Max issues to fetch (default: 10) |
|
|
| Natural language UI instructions for the LLM |
Pull requests are filtered out; only issues are returned.
Environment Variables
Variable | Required | Description |
| Yes | DeepSeek API key |
| No | e.g. |
| No | Default |
| No | Higher GitHub rate limits |
| No | Default |
This server cannot be deployed
Maintenance
Related MCP Connectors
Browse, search and scan a public leaderboard of AI-generated GitHub repos.
Dive into the world of open-source with the GitHub Repo Explorer! Utilize the powerful GitHub
Finds real, maintained open-source repos that fit your project. MCP grounding for coding agents.
Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables analysis and querying of Git repository content (both public and private) through a unified tool that provides repository summaries, file structures, and full content optimized for LLM consumption.1-
- FlicenseNot gradedqualityDmaintenanceEnables fetching public repositories for a given GitHub username, returning curated data optimized for LLM context windows.-
- AlicenseNot gradedqualityCmaintenanceDiscover, rank, and compare GitHub repositories from any MCP-compatible AI client. Enables searching, filtering, ranking, and evaluating open-source repositories by topic, language, stars, license, activity, and relevance.MIT
- FlicenseAqualityDmaintenanceEnables natural-language queries about public GitHub repositories, including issues, pull requests, repo metadata, and READMEs, via the GitHub API.5-