JinDaGe - mcp-scholarly MCP Details

article

README

🚀 组件

本服务器提供了强大的功能，旨在为用户提供便捷的学术搜索体验。下面为你详细介绍其核心组件和使用方法。

🚀 快速开始

📦 安装指南

使用Claude Desktop

不同操作系统下，Claude Desktop的配置文件路径有所不同：

MacOS：~/Library/Application\ 支持/Claude/claude_desktop_config.json
Windows：%APPDATA%/Claude/claude_desktop_config.json%

开发/未发布的服务器配置

``` "mcpServers": { "mcp-scholarly": { "command": "uv", "args": [ "--directory", "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly", "run", "mcp-scholarly" ] } } ```

已发布的服务器配置

``` "mcpServers": { "mcp-scholarly": { "command": "uvx", "args": [ "mcp-scholarly" ] } } ```

如果你选择使用Docker，以下是已发布的Docker服务器配置：

已发布的Docker服务器配置

``` "mcpServers": { "mcp-scholarly": { "command": "docker", "args": [ "run", "--rm", "-i", "mcp/scholarly" ] } } ```

使用Smithery安装

你可以通过Smithery自动为Claude Desktop安装mcp-scholarly，只需运行以下命令：

npx -y @smithery/cli install mcp-scholarly --client claude

🔧 技术细节

构建和发布

为了准备分发包，你需要按照以下步骤操作：

同步依赖并更新锁定文件：

uv sync

构建包分布：

uv build

执行上述命令后，将在dist/目录中创建源代码和轮分布。 3. 发布到PyPI：

uv publish

⚠️ 重要提示

你需要通过环境变量或命令行参数设置PyPI凭证：

令牌：--token 或 UV_PUBLISH_TOKEN

或者用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈推荐使用MCP Inspector。

你可以通过npm运行以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly run mcp-scholarly

启动后，Inspector将在浏览器中显示一个URL，供你开始调试。

✨ 主要特性

工具

该服务器实现了一个实用工具——搜索arxiv，它可以在arxiv上搜索与给定关键词相关的文章。该工具接受“关键词”作为必需的字符串参数，为用户提供了便捷的学术文献搜索途径。

mcp-scholarly