Giiisp ArXiv 摘要搜索 MCP 服务器

基于模型上下文协议（MCP）的ArXiv论文摘要搜索服务器，通过Giiisp API提供便捷的学术论文摘要搜索功能。

✨ 功能特性

• 🔍 摘要搜索 - 根据摘要内容关键词搜索ArXiv论文
• 📝 智能匹配 - 在论文摘要中精确匹配搜索关键词
• ⚡ 快速响应 - 30秒超时，优化性能
• 🛡️ 健壮的错误处理 - 全面的错误管理机制
• 📊 详细日志记录 - 便于调试的日志系统
• 🔧 简单集成 - 简洁的MCP协议实现
• 📄 灵活分页 - 可自定义返回数据条数

🚀 快速开始

安装

npm install -g giiisp-arxiv-mcp

使用方式

作为全局命令

giiisp-arxiv-mcp

作为MCP服务器

服务器将启动并监听通过stdio的MCP协议消息。

与Claude Desktop集成

要在Claude Desktop中使用此MCP服务器，请将以下内容添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "giiisp-arxiv-mcp": {
      "command": "npx",
      "args": ["-y", "giiisp-arxiv-mcp"]
    }
  }
}

添加此配置后，重启Claude Desktop，您就可以通过MCP接口直接搜索ArXiv论文了。

开发安装

git clone https://github.com/giiisp/giiisp-arxiv-mcp.git
cd giiisp-arxiv-mcp
npm install
npm start

📖 使用说明

MCP工具集成

服务器提供searchArxivByAbstract工具用于搜索ArXiv论文摘要：

参数：

• key (字符串, 必需): 搜索关键词，用于在论文摘要内容中搜索
• pageSize (数字, 可选): 返回的数据条数，默认为10

搜索说明： 此服务专门用于在ArXiv论文的摘要部分进行关键词搜索，能够精确匹配摘要内容中的相关术语和概念。

示例：

基本摘要搜索：

{
  "name": "searchArxivByAbstract",
  "arguments": {
    "key": "artificial intelligence"
  }
}

自定义返回条数的摘要搜索：

{
  "name": "searchArxivByAbstract",
  "arguments": {
    "key": "machine learning",
    "pageSize": 20
  }
}

中文摘要关键词搜索：

{
  "name": "searchArxivByAbstract",
  "arguments": {
    "key": "深度学习",
    "pageSize": 5
  }
}

响应格式：

{
  "success": true,
  "status": 200,
  "data": {
    // API响应数据，包含论文信息
  },
  "message": "ArXiv论文摘要搜索完成",
  "searchParams": {
    "key": "artificial intelligence",
    "pageSize": 10
  }
}

🔧 技术细节

• 超时时间: 30秒
• 请求头: 自动设置Content-Type和User-Agent
• 错误处理: 区分网络、API和超时错误
• 日志记录: 详细的请求和响应日志

🛠️ 错误处理

服务器处理以下错误类型：

• 超时错误: 请求超过30秒
• 网络错误: 无法连接到API服务器
• API错误: 服务器返回错误状态码
• 参数错误: 缺少必需参数或类型不正确

🧪 测试

运行测试套件：

npm test

这将测试：

• API连接性
• 参数验证
• 错误处理

📁 项目结构

├── server.js              # 主服务器文件
├── package.json           # 项目配置和依赖
├── README.md             # 项目文档
├── LICENSE               # MIT许可证
├── .gitignore           # Git忽略规则
└── test/
    └── test-api.js       # 测试套件

🚀 开发

调试模式

使用Node.js调试器运行调试模式：

npm run dev

在调试器中设置断点进行开发。

贡献

1. Fork仓库
2. 创建功能分支
3. 进行更改
4. 为新功能添加测试
5. 提交拉取请求

📄 许可证

MIT许可证 - 详见LICENSE文件。

🤝 支持

• 问题反馈: GitHub Issues
• 邮箱: [email protected]

🔗 相关链接

• Giiisp数据库
• 模型上下文协议
• npm包