Mcportal MCP server

by yonghwan1106·io.github.yonghwan1106/mcportal·v0.2.2

No reviews yet

Quota-guarded MCP layer over Korean public data APIs (data.go.kr), compiled from OpenAPI specs

A88/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A88/100

full report

Adoption

New

0 stars74 downloads/wk

Reviews

Write one

Nobody has reviewed Mcportal yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mcportal tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it

no findings

Code scan46 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 81 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Mcportal compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 88/100; higher than 75% of 48,255 servers
Downloads a week: 74; more than 55% of 12,191 servers with a package

Install Mcportal in Claude Code, Cursor or VS Code

claude mcp add mcportal -- uvx mcportal

Add to Cursor

What the publisher says

From the Mcportal repository's README, as published. We do not edit it. Read it on GitHub

MCPortal

The missing bridge between data.go.kr and the global MCP ecosystem. MCPortal normalizes Korean public-API specifications into standard OpenAPI 3.1, compiles them into MCP servers, and puts every outbound call behind a hard daily budget with backoff and caching. Fully open source, fully self-hosted.

한국어 문서: README.ko.md — this English README is the canonical document and the Korean file is a translation of it.

Accuracy disclaimer

data.go.kr publishes no "remaining quota" endpoint. MCPortal's usage ledger

therefore counts only the calls that went through MCPortal, which makes it

a best-effort estimate. Calls that the same serviceKey spends outside

MCPortal — another script, the portal console, a different tool — never reach

the ledger, so the ledger value is always a lower-bound approximation of real

consumption. The axis of trust is not that estimate but the **hard budget cap

(CALLBUDGET). Even when the ledger is wrong, the hard guard physically

blocks calls beyond the daily cap, so the safety line against quota-related

account sanctions always comes from CALL_BUDGET.

The no-key boundary

Every demo, development and CI path in MCPortal runs without a key. The record/replay layer replays cassettes that were recorded earlier, so the same response flow can be reproduced and the whole test suite can go green with no serviceKey present. Spec-to-MCP conversion has already happened at build time — the compiled artifacts are committed under specs/ — so clone the repository and even standing up an MCP server and answering tool calls needs no key: mcportal serve 15000115 --replay serves eight tools over stdio with no serviceKey anywhere in the environment.

That sentence says clone on purpose. Replay needs a cassette, and cassettes are recorded upstream responses that stay in the repository instead of going out in the wheel (note 1), so a bare pip install mcportal has nothing to replay until it is pointed at a checkout with --presets-root or MCPORTALPRESETS=. Cassettes exist for three of the four bundles — 15081808 has none in the repository either, because it was deliberately left out of sampling (see Presets* below), so that one bundle is live-only.

What does need a key is narrow: live traffic to data.go.kr, and sampling or converting an API that has no cassette yet.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Mcportal: common questions

Is Mcportal MCP server safe?: Yes, by our scan: it is graded A (88/100). Read the Mcportal safety report
How do I install Mcportal?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Mcportal need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Mcportal maintained?: The last commit was 81 days ago (2026-08-14). The latest release is v0.2.2.
How does Mcportal compare with other MCP servers?: safety score 88/100 (higher than 75% of 48,255 servers); downloads a week 74 (more than 55% of 12,191 servers with a package). Full comparison.