Skip to main content
Glama
ckgerteis

korea-scholarship-mcp

by ckgerteis
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KCI_API_KEYNoYour KCI API key from open.kci.go.kr. Required only for the four KCI REST tools (kci_search, kci_article, kci_references, kci_journal_metrics); the OAI-PMH and status tools work without it.
MCP_RECEIPT_DIRNoOptional path to a receipts folder for the query ledger. If set, query receipts are written as hash-chained files.
MCP_RECEIPT_LOGNoLegacy alternative to MCP_RECEIPT_DIR. If set, query receipts are written to this log file.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
kci_searchA

Search KCI articles (REST, requires KCI_API_KEY).

title is mandatory — the KCI API rejects a query without it, so a subject-led search must be run as a title query and again as a keyword query, and the two sets unioned by hand. date_from/date_to are YYYYMM. rows is capped at 100 by the API.

Two asymmetries this tool reports rather than hides: articleSearch accepts keyword as a search field but omits author keywords, ISSN and UCI from its response, so an empty keywords list here means the endpoint did not return them, not that the article has none — use kci_article to recover them per record.

kci_articleA

Full KCI record for one control number (e.g. ART001995054).

This is the only endpoint that carries author keywords, ISSN, author affiliations and the abstracts. Use it to repair records returned by kci_search.

kci_referencesA

Works cited by one KCI article (referenceSearch).

KCI's reference data is contributed by publishers and is uneven: an empty list is as likely to mean the publisher deposited no reference block as that the article cites nothing. Read it as a floor, never a count.

kci_journal_metricsA

KCI journal citation indices (impact factor, immediacy, self-citation share).

Supply journal for the list view or journal_id for one journal's history. years must be 2–5.

These are bibliometric artefacts of a national index with a small, largely domestic citing population. They measure position within KCI, not standing in a field, and should not be used to rank scholarship.

kci_harvestA

Harvest KCI by OAI-PMH — no API key required.

date_from/date_to are YYYY-MM-DD and select on KCI ingest datestamp, not publication date: a July 2026 window returns articles published in 2015. There is no query interface, so contains is applied client-side to whatever the window yielded. Sets: ARTI (article), ARTI_CONF (conference), JOUR (journal).

This is a harvesting tool wearing a search tool's clothes. Treat a result as a slice of the accession stream, and say so in anything built on it.

oak_harvestA

Harvest Open Access Korea by OAI-PMH — no API key required.

date_from/date_to are YYYY-MM-DD ingest datestamps. OAK declares no set hierarchy and — verified 19 Aug 2026 — sends no resumptionToken, so a window returns at most about 99 records and there is no way to ask for the rest. When the cap is hit this tool says so and tells you to narrow the window; it will not present a truncated window as a complete one.

Windows are lumpy: a single repository's bulk deposit can fill one entirely, so the tool also reports which holding organisation dominates.

oak_recordB

One OAK record by OAI identifier (oai:oak.go.kr:NNNNNNNN, or the bare number).

korea_sources_statusA

Report which Korean sources are configured and reachable right now.

Checks the KCI REST key, the two keyless OAI endpoints, and states plainly what this server does not cover (ScienceON, RISS, DBpia) and why.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 8 tools

Disambiguation5/5

Each tool targets a different function—search, record detail, references, journal metrics, OAI harvesting, or source status—and the descriptions explicitly distinguish overlapping endpoints such as kci_search vs kci_harvest. The KCI search/detail pair is clearly separated by 'use kci_article to repair records returned by kci_search', so an agent should not confuse them. No two tools appear to do the same thing.

Naming Consistency4/5

All tool names are lowercase, snake_case, and consistently source-prefixed (kci_, oak_, korea_). However, the set mixes noun-style retrieval names (kci_article, kci_references, kci_journal_metrics, oak_record) with verb-style names (kci_search, kci_harvest, oak_harvest), so it is readable but not a uniform verb_noun convention. This is a minor deviation rather than chaos.

Tool Count5/5

Eight tools is a well-scoped size for a Korean scholarship metadata server covering two source families plus a status tool. Each tool contributes a distinct capability—search, detail, references, metrics, harvesting, and operational health—so none feels redundant or out of place.

Completeness4/5

The set covers KCI search, detail, references, journal metrics, and OAI harvesting, plus OAK harvesting, OAK record retrieval, and source status. The main minor gaps are the lack of an OAK search endpoint and the hard ~99-record harvest cap, but the tool descriptions explicitly document these and offer workarounds such as narrowing windows or using kci_article to enrich search results.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources