korea-scholarship-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KCI_API_KEY | No | Your 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_DIR | No | Optional path to a receipts folder for the query ledger. If set, query receipts are written as hash-chained files. | |
| MCP_RECEIPT_LOG | No | Legacy 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kci_searchA | Search KCI articles (REST, requires KCI_API_KEY).
Two asymmetries this tool reports rather than hides: articleSearch accepts
|
| 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 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.
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.
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). |
| dbpia_linksA | Compose DBpia addresses for the user to open; sends nothing to DBpia. DBpia's terms forbid storing or transmitting its results, so this tool
never queries it. Give |
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct source+operation (KCI search/article/harvest/metrics/references, OAK harvest/record, DBpia link composition, status check), and the descriptions explicitly delimit the tricky boundary between kci_search and kci_harvest. Minor residual overlap remains between kci_search and kci_article since both return article records, though the 'repair records' framing helps.
Naming follows a clear source-prefix scheme (kci_*, oak_*, dbpia_*) that makes family membership obvious. The lone outlier korea_sources_status breaks that pattern, and noun-style names (kci_article, kci_references, oak_record) are mixed with verb-style ones (kci_search, kci_harvest), but it remains readable and predictable.
Nine tools is squarely in the well-scoped range, and each earns its place by covering a distinct source or operation. Nothing looks redundant or bolted on, and the surface is small enough for an agent to hold in mind.
The surface covers the KCI lifecycle (search, full record, harvest, references, journal metrics) and OAK harvest/record, with explicitly justified exclusions (ScienceON, RISS, DBpia search) surfaced by a status tool. Gaps are minor: no cross-source unified search, no OAK metadata search (only harvest plus identifier lookup), and no built-in export/citation formatting.