{
  "markdown": "# Vivory MCP Servers\n\n**Korean public-data MCP servers for AI agents** — KOSIS Statistics Korea (live), BoK ECOS · NEIS · LOCALDATA (planned).\n\nBuilt and maintained by **[Vivory](https://vivory.app)**. Backend powered by the [Vivory Korea Data Gateway](https://api.vivory.app).\n\n[![PyPI - Version](https://img.shields.io/pypi/v/vivory-mcp-kosis.svg)](https://pypi.org/project/vivory-mcp-kosis/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n---\n\n## Why\n\nKorean public statistics (population, GDP, CPI, employment, trade, etc.) are published by official agencies via Korean-only APIs that require local accounts and return JS-literal responses with mixed taxonomies. This repo packages them as [Model Context Protocol](https://modelcontextprotocol.io) servers so any MCP-compatible client (Claude Desktop, Claude Code, etc.) can query Korean data in English with zero setup.\n\n```\nForeign user → Claude → vivory-mcp-* → api.vivory.app → kosis.kr / ecos.bok.or.kr / etc.\n                                       (caching, attribution, normalization)\n```\n\nNo KOSIS account, no API key, no Korean phone — just install and ask.\n\n---\n\n## Packages\n\nThis is a monorepo of MCP server packages. Each is independently installable from PyPI.\n\n| Package | Status | Tools | Source |\n|---|---|---|---|\n| **[`vivory-mcp-kosis`](packages/mcp-server-kosis)** | Live | 15 | KOSIS — Statistics Korea curated key indicators |\n| **[`vivory-mcp-korea`](packages/mcp-server-korea)** | Live (KOSIS only) | 15 | Umbrella — adds BoK ECOS, NEIS, LOCALDATA, etc. as v0.2+ |\n\n### Recommended:\n\n- **One source only** → install the dedicated package (`vivory-mcp-kosis`)\n- **All Korean data** → install the umbrella (`vivory-mcp-korea`) — auto-grows as we add sources\n\n---\n\n## Quick install (Claude Desktop)\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"vivory-kosis\": {\n      \"command\": \"uvx\",\n      \"args\": [\"vivory-mcp-kosis\"]\n    }\n  }\n}\n```\n\nOr to use the umbrella (all Korean data):\n\n```json\n{\n  \"mcpServers\": {\n    \"vivory-korea\": {\n      \"command\": \"uvx\",\n      \"args\": [\"vivory-mcp-korea\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The tools appear in the tool palette.\n\n> **PyPI release pending** — until then use:\n> ```\n> uvx --from \"git+https://github.com/jayjodev/vivory-mcp.git#subdirectory=packages/mcp-server-kosis\" vivory-mcp-kosis\n> ```\n\n---\n\n## Example prompts\n\nAsk Claude (or any MCP client):\n\n> *\"What's Korea's CPI trend over the last 24 months?\"*\n> *\"Show me Korean quarterly GDP growth, last 12 quarters.\"*\n> *\"Search KOSIS for tables related to youth unemployment.\"*\n> *\"What's the indicator ID for 추계인구?\"*\n\nClaude picks the right tool automatically.\n\n---\n\n## Architecture\n\n```\npackages/\n├── mcp-server-kosis/          # KOSIS standalone MCP server\n│   ├── src/vivory_mcp_kosis/\n│   │   ├── server.py          # 15 KOSIS tool definitions\n│   │   └── client.py          # HTTP wrapper to api.vivory.app\n│   ├── pyproject.toml\n│   └── README.md\n│\n└── mcp-server-korea/          # Umbrella MCP server\n    ├── src/vivory_mcp_korea/\n    │   ├── server.py          # Aggregates tools from all sources\n    │   ├── client.py\n    │   └── tools/\n    │       ├── kosis.py       # KOSIS tool catalog\n    │       └── (ecos.py, neis.py, etc. — planned)\n    └── ...\n```\n\nAll packages are **thin wrappers** — no API keys, no rate limit handling, no parsing logic. They translate MCP tool calls → HTTP GETs against [api.vivory.app](https://api.vivory.app), where the heavy lifting lives.\n\n---\n\n## Self-hosting\n\nSet `VIVORY_API_BASE` to point at your own backend:\n\n```bash\nexport VIVORY_API_BASE=\"http://localhost:8000/api\"\n```\n\nThe Vivory backend code is **not** in this repo (it lives in the private Vivory app monorepo). If you want to run the full stack, you'll need to implement the `/api/public-tools/kosis/*` endpoints yourself or contact us about licensing.\n\n---\n\n## License\n\n- **MCP wrapper code** (this repo): MIT\n- **KOSIS data**: 공공누리(KOGL) Type 1 — commercial use permitted with attribution\n- **Other sources**: per-source license (see each package's README)\n\nEvery tool response includes an `attribution` block. When citing or redistributing data, include the `attribution_required` text.\n\n---\n\n## Contributing\n\nIssues and PRs welcome. Specifically interested in:\n\n- Adding more Korean public data sources to the umbrella\n- Improving tool descriptions for better LLM tool-use accuracy\n- Adapting for other MCP clients beyond Claude\n\n---\n\n## Project status\n\n- **Repo source of truth**: this repo (`vivory-mcp`) — packages here mirror what's published to PyPI\n- **Vivory backend**: private (api.vivory.app)\n- **Issues / discussions**: [github.com/jayjodev/vivory-mcp/issues](https://github.com/jayjodev/vivory-mcp/issues)\n\n---\n\n🇰🇷 Built in Seoul · 🌐 [vivory.app](https://vivory.app)\n",
  "bytes": 4932,
  "sha": "bf67c85de6e71d96e533c1a4493da04330155669a88d668eb6fcacadb5659f3d",
  "repo_slug": "jayjodev/vivory-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jayjodev_vivory_mcp_verificati_868961d1/readme"
}