Skip to main content
Glama
renyumeng1

mcp-scholar

by renyumeng1

MCP Scholar

基于MCP协议的谷歌学术搜索和分析服务。

功能特点

  • 谷歌学术论文搜索:根据关键词搜索相关论文,并按引用量排序

  • 学者主页分析:分析谷歌学术个人主页,提取引用量最高的论文

  • 支持与所有支持MCP客户端集成

  • 支持与Cherry Studio集成:可以作为插件在Cherry Studio中使用

Related MCP server: Scholar MCP

安装方法

启动服务器

# 方式一:使用uvx启动
uvx mcp-scholar

# 方式二:clone仓库后使用uv run启动
uv --directory 路径\到\mcp_scholar run mcp-scholar

在Cherry Studio中使用

示例用法

在Cherry Studio中,可以使用以下提示:

开发说明

本项目使用MCP协议开发,基于Python SDK实现。详细信息请参考MCP Python SDK

许可证

MIT

Available Tools

7 tools
health_checkB
健康检查端点,用于验证服务是否正常运行

Returns:
    str: 服务状态信息
ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/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 tool returns service status information, which implies a read-only, non-destructive operation, but doesn't explicitly confirm this or describe other traits like error handling, response format details, or any side effects. For a tool with zero annotation coverage, this is a significant gap in behavioral context.

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

Conciseness4/5

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

The description is appropriately sized and front-loaded: it starts with the purpose in the first sentence and follows with return information. There's no wasted text, and every sentence earns its place. However, it could be slightly more structured by separating the return statement more clearly, but it remains efficient overall.

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?

Given the tool's low complexity (0 parameters, no output schema, no annotations), the description is minimally complete. It states the purpose and return type, which is adequate for a simple health check tool. However, it lacks details on what '服务状态信息' (service status information) entails, such as possible values or error cases, making it somewhat incomplete for full contextual understanding.

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

Parameters4/5

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

The tool has 0 parameters, and schema description coverage is 100% (since there are no parameters to describe). The description doesn't need to add parameter semantics beyond what the schema provides. According to the rules, 0 parameters baseline is 4, as there's nothing to compensate for, and the description doesn't contradict or add unnecessary details.

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

Purpose4/5

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

The description clearly states the tool's purpose: '健康检查端点,用于验证服务是否正常运行' (health check endpoint to verify if the service is running normally). It uses a specific verb ('验证' - verify) and resource ('服务' - service), making the purpose unambiguous. However, it doesn't differentiate from sibling tools, which are all unrelated to health checks, so it doesn't need sibling differentiation but doesn't explicitly state this uniqueness.

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. It doesn't mention any context, prerequisites, or exclusions for usage. Since sibling tools are unrelated (e.g., adaptive_search, paper_detail), there's no explicit comparison or when-not-to-use advice, leaving usage unclear beyond the basic purpose.

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

paper_detailC
获取论文详细信息

Args:
    paper_id: 论文ID

Returns:
    Dict: 论文详细信息
ParametersJSON Schema
NameRequiredDescriptionDefault
paper_idYes

TDQS

C2.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 full burden for behavioral disclosure. It states it retrieves details but doesn't mention whether this is a read-only operation, requires authentication, has rate limits, or what happens with invalid paper IDs. For a tool with zero annotation coverage, this represents significant gaps in behavioral context.

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

Conciseness4/5

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

The description is appropriately brief with clear sections for Args and Returns. However, the Chinese text '获取论文详细信息' could be more specific, and the structure while clean doesn't fully compensate for content gaps. It's efficient but could be more informative within its concise format.

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

Completeness2/5

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

For a tool with no annotations, no output schema, and 0% schema description coverage, the description is insufficient. It doesn't explain what '论文详细信息' (paper details) includes, the return format beyond 'Dict', error conditions, or how this differs from sibling tools. The minimal information provided doesn't adequately support tool invocation.

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

Parameters2/5

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

Schema description coverage is 0%, so the schema provides no parameter documentation. The description only states 'paper_id: 论文ID' (paper ID), which adds minimal semantic value beyond the parameter name. It doesn't explain format requirements, valid ranges, or examples of paper IDs, leaving the single parameter inadequately documented.

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

Purpose3/5

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

The description states '获取论文详细信息' (Get paper details), which provides a basic verb+resource combination. However, it doesn't differentiate from sibling tools like 'paper_references' or 'profile_papers' that might also retrieve paper-related information. The purpose is clear but lacks specificity about what distinguishes this tool from alternatives.

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?

No guidance is provided about when to use this tool versus alternatives like 'paper_references' or 'profile_papers'. The description only states what the tool does without indicating appropriate contexts, prerequisites, or exclusions. This leaves the agent without direction on tool selection.

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

paper_referencesA
获取引用指定论文的文献列表

Args:
    paper_id: 论文ID
    count: 返回结果数量,默认为5
    sort_by: 排序方式,可选值:
        - "relevance": 按相关性排序(默认)
        - "citations": 按引用量排序
        - "date": 按发表日期排序(新到旧)
        - "title": 按标题字母顺序排序

Returns:
    Dict: 引用论文列表
ParametersJSON Schema
NameRequiredDescriptionDefault
countNo
paper_idYes
sort_byNorelevance

TDQS

A3.9/5.0
Behavior3/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. It discloses basic behavioral traits: it's a read operation (implied by '获取' - get), returns a list of papers, and has default values and sorting options. However, it lacks details on error handling, rate limits, authentication needs, or what the returned dict structure contains. For a tool with no annotations, this provides minimal but not comprehensive behavioral context.

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 well-structured and appropriately sized. It starts with a clear purpose statement, followed by organized sections for Args and Returns. Each sentence adds value: the purpose is stated upfront, parameters are explained concisely with defaults and options, and the return type is specified. There's no redundant or wasted information.

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?

Given the tool's moderate complexity (3 parameters, no annotations, no output schema), the description is fairly complete. It covers the purpose, all parameters with semantics, and the return type. However, it lacks details on the return value structure (e.g., what keys are in the dict), error cases, or performance considerations. For a tool without annotations or output schema, this is good but not fully comprehensive.

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

Parameters5/5

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

The description adds significant meaning beyond the input schema, which has 0% description coverage. It explains each parameter: 'paper_id' as the paper ID, 'count' as the number of results with a default of 5, and 'sort_by' with detailed options and their meanings (relevance, citations, date, title). This fully compensates for the schema's lack of descriptions, providing clear semantics for all three parameters.

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

Purpose4/5

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

The description clearly states the tool's purpose: '获取引用指定论文的文献列表' (Get a list of papers that reference the specified paper). It uses a specific verb ('获取' - get) and resource ('文献列表' - paper list), but doesn't explicitly differentiate from sibling tools like 'paper_detail' or 'scholar_search'. The purpose is clear but sibling differentiation is only implied through the specific focus on references.

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 context through the parameter explanations (e.g., '默认为5' - default is 5, '可选值' - optional values), suggesting when certain options might be appropriate. However, it doesn't provide explicit guidance on when to use this tool versus alternatives like 'scholar_search' or 'paper_detail', nor does it mention prerequisites or exclusions. Usage is contextually implied but not explicitly stated.

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

profile_papersB
获取学者的论文

Args:
    profile_url: 谷歌学术个人主页URL
    count: 返回结果数量,默认为5
    sort_by: 排序方式,可选值:
        - "relevance": 按相关性排序(默认)
        - "citations": 按引用量排序
        - "date": 按发表日期排序(新到旧)
        - "title": 按标题字母顺序排序

Returns:
    Dict: 论文列表
ParametersJSON Schema
NameRequiredDescriptionDefault
countNo
profile_urlYes
sort_byNorelevance

TDQS

B3.3/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 full responsibility for behavioral disclosure. It mentions the tool retrieves papers and describes parameters, but lacks critical behavioral details: it doesn't specify data source limitations (e.g., Google Scholar scraping constraints), rate limits, authentication needs, error handling, or what the returned 'Dict: 论文列表' (paper list dictionary) contains structurally. For a tool with no annotations, this leaves significant gaps in understanding its operational behavior.

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

Conciseness4/5

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

The description is well-structured with clear sections for Args and Returns, making it easy to parse. It's appropriately sized with no redundant information. However, the front-loaded purpose statement ('获取学者的论文') is very brief and could be more informative, slightly reducing efficiency in immediate understanding.

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?

Given the tool's moderate complexity (3 parameters, no annotations, no output schema), the description is partially complete. It excels in parameter documentation but lacks output details (only states 'Dict: 论文列表' without structure), behavioral context, and differentiation from siblings. For a tool with no annotations or output schema, more comprehensive coverage would be needed for full contextual understanding, leaving it at a minimum viable level.

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

Parameters5/5

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

The description adds substantial value beyond the input schema, which has 0% schema description coverage. It clearly explains all three parameters: 'profile_url' as a Google Scholar profile URL, 'count' as the number of results with a default of 5, and 'sort_by' with four explicit options and their meanings. This fully compensates for the schema's lack of descriptions, providing complete parameter semantics.

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

Purpose4/5

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

The description clearly states the verb ('获取' meaning 'get' or 'retrieve') and resource ('学者的论文' meaning 'scholar's papers'), making the purpose immediately understandable. However, it doesn't explicitly differentiate this tool from sibling tools like 'scholar_search' or 'paper_detail', which likely have overlapping domains. The title is null, so the description carries the full burden of purpose communication.

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. With sibling tools like 'scholar_search' and 'paper_detail' available, there's no indication of whether this tool is for a specific scholar's papers versus general search, or how it differs in scope or functionality. The user must infer usage from the parameter requirements alone.

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

summarize_papersB
搜索并总结特定主题的论文

Args:
    topic: 研究主题
    count: 返回结果数量,默认为5
    sort_by: 排序方式,可选值:
        - "relevance": 按相关性排序(默认)
        - "citations": 按引用量排序
        - "date": 按发表日期排序(新到旧)
        - "title": 按标题字母顺序排序
    year_start: 开始年份,可选
    year_end: 结束年份,可选

Returns:
    str: 论文总结的Markdown格式文本
ParametersJSON Schema
NameRequiredDescriptionDefault
countNo
sort_byNorelevance
topicYes
year_endNo
year_startNo

TDQS

B3.4/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 full burden. It mentions searching and summarizing but doesn't disclose behavioral traits like rate limits, authentication needs, data sources, or potential errors. The description is functional but lacks operational context needed for a tool with no annotation coverage.

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 appropriately sized and well-structured: a brief purpose statement followed by clearly labeled Args and Returns sections. Every sentence earns its place by providing essential information without redundancy. It's front-loaded with the core function.

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?

Given no annotations, 0% schema coverage, and no output schema, the description does well on parameters but lacks behavioral context. It explains what the tool does and its inputs thoroughly but doesn't cover output format details (beyond 'Markdown format text'), error handling, or operational constraints. Adequate but with clear gaps for a search/summarize tool.

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

Parameters5/5

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

Schema description coverage is 0%, so the description must compensate. It provides detailed parameter semantics: 'topic' as research topic, 'count' with default 5, 'sort_by' with enum values and defaults, and optional year filters. This adds significant meaning beyond the bare schema, fully documenting all parameters.

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

Purpose4/5

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

The description clearly states the tool's purpose as '搜索并总结特定主题的论文' (search and summarize papers on a specific topic), which is a specific verb+resource combination. It distinguishes from siblings like 'paper_detail' (detailed view) and 'scholar_search' (search only), though not explicitly. The purpose is clear but lacks explicit sibling differentiation.

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?

No guidance is provided on when to use this tool versus alternatives like 'adaptive_search' or 'scholar_search'. The description implies usage for summarizing papers but doesn't specify contexts, prerequisites, or exclusions. It's a basic functional statement without strategic guidance.

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

TDQS

B3.1/5.0
Disambiguation2/5

There is significant overlap between adaptive_search and scholar_search, both performing Google Scholar searches with similar parameters, which creates ambiguity. Additionally, summarize_papers appears to combine searching and summarization, potentially overlapping with the search tools, though its summarization aspect provides some distinction.

Naming Consistency4/5

Most tools follow a clear noun_verb or verb_noun pattern (e.g., adaptive_search, paper_detail, summarize_papers), with consistent snake_case throughout. The only minor deviation is health_check, which fits the pattern but stands out as a utility tool rather than a core scholarly function.

Tool Count4/5

With 7 tools, the count is reasonable for a scholarly search server, covering key operations like searching, retrieving details, and summarizing. However, the overlap between some tools suggests the set could be streamlined without losing functionality, making it slightly over-scoped.

Completeness4/5

The toolset covers core scholarly functions well, including searching, retrieving paper details, references, and scholar profiles, with summarization as an advanced feature. A minor gap is the lack of tools for managing saved papers or citations, but the existing tools support most common workflows without dead ends.

Maintenance

ActivityInactive
ResponsivenessSyncing

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
    A local MCP server that allows users to search Google Scholar for academic papers by topic, author, and year range without requiring API keys. It utilizes web scraping to provide paginated results for research and academic exploration through natural language.
    6
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables academic research by searching Google Scholar, fetching paper content, and converting web pages to clean Markdown.
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server for searching Google Scholar, enabling paper search, author lookup, citation tracking, and BibTeX export for AI assistants and automation workflows.
    2
    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/renyumeng1/mcp_scholar'

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