🚀 组件
本服务器提供了强大的功能，旨在为用户提供便捷的学术搜索体验。下面为你详细介绍其核心组件和使用方法。
🚀 快速开始
📦 安装指南
使用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上搜索与给定关键词相关的文章。该工具接受“关键词”作为必需的字符串参数，为用户提供了便捷的学术文献搜索途径。