Skip to main content
Glama
TaehongKim

classScopusMCP

by TaehongKim

ClassScopus MCP Tool

๐Ÿ“š Model Context Protocol (MCP) ๋„๊ตฌ๋กœ ํ•™์ˆ  ๋…ผ๋ฌธ ๊ฒ€์ƒ‰ ๋ฐ ์ดˆ๋ก ๊ฐ€์ ธ์˜ค๊ธฐ

Scopus, Crossref, PubMed API๋ฅผ ํ†ตํ•ฉํ•˜์—ฌ ๋…ผ๋ฌธ์„ ๊ฒ€์ƒ‰ํ•˜๊ณ  ์ดˆ๋ก์„ ๊ฐ€์ ธ์˜ค๋Š” MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. Claude Desktop, Cursor, Ollama ๋“ฑ MCP๋ฅผ ์ง€์›ํ•˜๋Š” ๋ชจ๋“  AI ํด๋ผ์ด์–ธํŠธ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

โœจ ์ฃผ์š” ๊ธฐ๋Šฅ

  • ๐Ÿ” ๋…ผ๋ฌธ ๊ฒ€์ƒ‰: Scopus API๋ฅผ ํ†ตํ•œ ๊ฐ•๋ ฅํ•œ ํ•™์ˆ  ๋…ผ๋ฌธ ๊ฒ€์ƒ‰

  • ๐Ÿ“„ ์ดˆ๋ก ๊ฐ€์ ธ์˜ค๊ธฐ: Crossref, PubMed์—์„œ ์ž๋™์œผ๋กœ ์ดˆ๋ก ์ˆ˜์ง‘

  • ๐Ÿ”„ ๋‹ค์ค‘ ์†Œ์Šค: ์—ฌ๋Ÿฌ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์—์„œ ์ตœ๊ณ  ํ’ˆ์งˆ์˜ ์ดˆ๋ก ์„ ํƒ

  • ๐Ÿ›ก๏ธ ๋ณด์•ˆ: ํ™˜๊ฒฝ๋ณ€์ˆ˜๋ฅผ ํ†ตํ•œ ์•ˆ์ „ํ•œ API ํ‚ค ๊ด€๋ฆฌ

  • ๐Ÿš€ ๊ฐ„ํŽธ ์„ค์น˜: npx๋กœ ์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅ

  • ๐Ÿ Python ๋ ˆ๊ฑฐ์‹œ: ๊ธฐ์กด Python ๋ฒ„์ „ ์ฝ”๋“œ ํฌํ•จ

Related MCP server: Crossref Academic MCP Server

๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘

1. ์„ค์น˜

# NPM์„ ํ†ตํ•œ ์ „์—ญ ์„ค์น˜
npm install -g abstract-search-mcp

# ๋˜๋Š” npx๋กœ ์ฆ‰์‹œ ์‚ฌ์šฉ
npx abstract-search-mcp

2. API ํ‚ค ์„ค์ •

Scopus API ํ‚ค๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. Elsevier Developer Portal์—์„œ ๋ฌด๋ฃŒ๋กœ ๋ฐœ๊ธ‰๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• 1: ํ™˜๊ฒฝ๋ณ€์ˆ˜ (๊ถŒ์žฅ)

export SCOPUS_API_KEY="your_scopus_api_key_here"

๋ฐฉ๋ฒ• 2: ์„ค์ • ํŒŒ์ผ

# config.json ํŒŒ์ผ ์ƒ์„ฑ
cp config.example.json config.json
# config.json ํŒŒ์ผ์„ ํŽธ์ง‘ํ•˜์—ฌ API ํ‚ค ์ž…๋ ฅ

3. MCP ํด๋ผ์ด์–ธํŠธ ์„ค์ •

Claude Desktop

~/.claude_desktop_config.json (macOS) ๋˜๋Š” %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "abstract-search": {
      "command": "npx",
      "args": ["abstract-search-mcp"],
      "env": {
        "SCOPUS_API_KEY": "your_scopus_api_key_here"
      }
    }
  }
}

Cursor

ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์˜ .cursor/mcp_config.json:

{
  "mcpServers": {
    "abstract-search": {
      "command": "npx",
      "args": ["abstract-search-mcp"],
      "env": {
        "SCOPUS_API_KEY": "your_scopus_api_key_here"
      }
    }
  }
}

Ollama

MCP ์„ค์ • ํŒŒ์ผ์— ์ถ”๊ฐ€:

{
  "mcpServers": {
    "abstract-search": {
      "command": "npx",
      "args": ["abstract-search-mcp"],
      "env": {
        "SCOPUS_API_KEY": "your_scopus_api_key_here"
      }
    }
  }
}

๐Ÿ› ๏ธ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

๋…ผ๋ฌธ ๊ฒ€์ƒ‰

search_papers๋ฅผ ์‚ฌ์šฉํ•ด์„œ 'machine learning' ๊ด€๋ จ ๋…ผ๋ฌธ์„ 5๊ฐœ ๊ฒ€์ƒ‰ํ•ด์ค˜

DOI๋กœ ์ดˆ๋ก ๊ฐ€์ ธ์˜ค๊ธฐ

get_abstract_by_doi๋ฅผ ์‚ฌ์šฉํ•ด์„œ DOI '10.1038/nature12373'์˜ ์ดˆ๋ก์„ ๊ฐ€์ ธ์™€์ค˜

๐Ÿ“‹ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋„๊ตฌ

1. search_papers

ํ‚ค์›Œ๋“œ๋กœ ๋…ผ๋ฌธ์„ ๊ฒ€์ƒ‰ํ•˜๊ณ  ์ดˆ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

๋งค๊ฐœ๋ณ€์ˆ˜:

  • query (ํ•„์ˆ˜): ๊ฒ€์ƒ‰ํ•  ํ‚ค์›Œ๋“œ

  • count (์„ ํƒ): ๊ฒ€์ƒ‰ํ•  ๋…ผ๋ฌธ ์ˆ˜ (๊ธฐ๋ณธ๊ฐ’: 10, ์ตœ๋Œ€: 50)

2. get_abstract_by_doi

DOI๋กœ ํŠน์ • ๋…ผ๋ฌธ์˜ ์ดˆ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

๋งค๊ฐœ๋ณ€์ˆ˜:

  • doi (ํ•„์ˆ˜): ๋…ผ๋ฌธ์˜ DOI

๐Ÿ”ง ๊ฐœ๋ฐœ์ž ์ •๋ณด

๋กœ์ปฌ ๊ฐœ๋ฐœ

# ์ €์žฅ์†Œ ๋ณต์ œ
git clone https://github.com/TaehongKim/classScopusMCP.git
cd classScopusMCP

# ์˜์กด์„ฑ ์„ค์น˜
npm install

# ๋กœ์ปฌ ๋งํฌ
npm link

# ํ…Œ์ŠคํŠธ
npx abstract-search-mcp

ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

classScopusMCP/
โ”œโ”€โ”€ abstract-search-server.js    # ๋ฉ”์ธ MCP ์„œ๋ฒ„
โ”œโ”€โ”€ bin/
โ”‚   โ””โ”€โ”€ abstract-search.js       # ์‹คํ–‰ ๋ž˜ํผ
โ”œโ”€โ”€ config.example.json          # ์„ค์ • ํŒŒ์ผ ์˜ˆ์‹œ
โ”œโ”€โ”€ claude_desktop_config.example.json  # Claude Desktop ์„ค์ • ์˜ˆ์‹œ
โ”œโ”€โ”€ package.json                 # ํŒจํ‚ค์ง€ ์ •๋ณด
โ”œโ”€โ”€ .npmignore                   # NPM ๋ฌด์‹œ ํŒŒ์ผ
โ”œโ”€โ”€ README.md                    # ๋ฉ”์ธ ๋ฌธ์„œ
โ”œโ”€โ”€ MCP_SETUP_GUIDE.md          # MCP ์„ค์ • ๊ฐ€์ด๋“œ
โ”œโ”€โ”€ MCP_USAGE_GUIDE.md          # MCP ์‚ฌ์šฉ ๊ฐ€์ด๋“œ
โ”œโ”€โ”€ DEPLOYMENT.md               # ๋ฐฐํฌ ๊ฐ€์ด๋“œ
โ””โ”€โ”€ python-legacy/              # Python ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ
    โ”œโ”€โ”€ scopusAPI.py            # Python Scopus API
    โ”œโ”€โ”€ mcp_abstract_search_server.py  # Python MCP ์„œ๋ฒ„
    โ””โ”€โ”€ requirements_mcp.txt     # Python ์˜์กด์„ฑ

๐ŸŒ ์ง€์›ํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค

  • Scopus: ์ฃผ์š” ๊ฒ€์ƒ‰ ์—”์ง„

  • Crossref: DOI ๊ธฐ๋ฐ˜ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ๋ฐ ์ดˆ๋ก

  • PubMed: ์˜ํ•™/์ƒ๋ฌผํ•™ ๋…ผ๋ฌธ ์ดˆ๋ก

๐Ÿ“ ๋ผ์ด์„ ์Šค

MIT License - ์ž์„ธํ•œ ๋‚ด์šฉ์€ LICENSE ํŒŒ์ผ์„ ์ฐธ์กฐํ•˜์„ธ์š”.

๐Ÿค ๊ธฐ์—ฌํ•˜๊ธฐ

๊ธฐ์—ฌ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค! Issue๋ฅผ ์ƒ์„ฑํ•˜๊ฑฐ๋‚˜ Pull Request๋ฅผ ์ œ์ถœํ•ด ์ฃผ์„ธ์š”.

๐Ÿ“ž ์ง€์›

๐ŸŽฏ ๋กœ๋“œ๋งต

  • Scopus API ํ†ตํ•ฉ

  • Crossref API ํ†ตํ•ฉ

  • PubMed API ํ†ตํ•ฉ

  • MCP ์„œ๋ฒ„ ๊ตฌํ˜„

  • Python ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ ํฌํ•จ

  • arXiv API ํ†ตํ•ฉ

  • Google Scholar ์ง€์›

  • ์ธ์šฉ ์ •๋ณด ์ถ”๊ฐ€

  • ๋…ผ๋ฌธ ์ „๋ฌธ ๋งํฌ ์ œ๊ณต

  • ์บ์‹ฑ ๊ธฐ๋Šฅ ์ถ”๊ฐ€

๐Ÿ“š ์ถ”๊ฐ€ ๋ฌธ์„œ


Made with โค๏ธ for the academic research community

Available Tools

2 tools
get_abstract_by_doiB

DOI๋กœ ํŠน์ • ๋…ผ๋ฌธ์˜ ์ดˆ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

ParametersJSON Schema
NameRequiredDescriptionDefault
doiYes๋…ผ๋ฌธ์˜ DOI

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states that it fetches an abstract, but does not disclose error handling, return format, rate limits, or access requirements. This is a significant transparency gap for a tool with no other safety metadata.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no redundant words. It is front-loaded with the core function and contains zero filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple single-parameter fetch tool, the description is largely complete: it specifies the input (DOI) and implies the output (abstract). However, it omits details on error cases (e.g., invalid DOI) or what to do if no abstract exists. Given the tool's simplicity, this is a minor gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes the 'doi' parameter with 100% coverage, so the baseline is 3. The description simply says 'by DOI', which adds no new semantic meaning beyond the schema. No additional detail about the parameter format or requirements is provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค' - fetches) and clearly specifies the resource ('์ดˆ๋ก' - abstract) and the identifier ('DOI'). It distinguishes itself from the sibling tool 'search_papers' by focusing on retrieval by DOI rather than searching.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'search_papers'. There is no mention of prerequisites (e.g., having a DOI) or exclusions. The implied usage is 'when you have a DOI', but this is not explicit and no alternative is named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_papersA

ํ‚ค์›Œ๋“œ๋กœ ๋…ผ๋ฌธ์„ ๊ฒ€์ƒ‰ํ•˜๊ณ  ์ดˆ๋ก์„ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.

ParametersJSON Schema
NameRequiredDescriptionDefault
countNo๊ฒ€์ƒ‰ํ•  ๋…ผ๋ฌธ ์ˆ˜ (๊ธฐ๋ณธ๊ฐ’: 10, ์ตœ๋Œ€: 50)
queryYes๊ฒ€์ƒ‰ํ•  ํ‚ค์›Œ๋“œ

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the core search-and-abstract function but omits details like output format, result ordering, pagination, or access restrictions. For a read-only search tool, this minimal description offers limited insight.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that immediately conveys the tool's purpose. It contains no redundant information or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no output schema and no annotations, so the description must cover return behavior. It partially does by mentioning 'abstracts', but it does not describe the full result structure, count behavior, or possible errors. Given the tool's simplicity, this is a moderate gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both 'query' and 'count', so the baseline is 3. The tool description merely says 'keyword' and adds no extra semantic detail, such as how 'count' affects results or query syntax, thus failing to add value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches for papers by keyword and retrieves abstracts. This distinguishes it from the sibling tool get_abstract_by_doi, which operates by DOI, so the purpose is well-defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for keyword-based search but does not explicitly state when to use this tool versus the DOI-based sibling, nor does it mention any exclusions or alternative scenarios. Usage context is only inferred from the keyword parameter.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedget_abstract_by_doi
    • First observedsearch_papers

TDQS

A3.8/5.0
Disambiguation5/5

The two tools are clearly distinct: one searches by keyword, the other retrieves a specific paper by DOI. There is no ambiguity in purpose, as each targets a different lookup method.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern with snake_case: 'search_papers' and 'get_abstract_by_doi'. The naming is predictable and descriptive.

Tool Count4/5

While only two tools are provided, they are well-scoped for the stated purpose of searching papers and fetching abstracts by DOI. The count is slightly lean but not unreasonable for a focused utility.

Completeness4/5

The tool set covers the essential operations for finding papers and obtaining abstracts. Minor gaps exist, such as lack of citation data or full metadata retrieval, but the core workflow is complete.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    An MCP server for searching and downloading academic papers from multiple sources including arXiv, PubMed, bioRxiv, and Sci-Hub, designed for seamless integration with large language models like Claude Desktop.
    795
    57
    2,564
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A MCP server for academic literature retrieval, aggregating multiple data sources like arXiv, Crossref, OpenAlex, PubMed, and Semantic Scholar to provide search, details, citations, trends, and recommendations.
    4
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TaehongKim/classScopusMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server