使用说明
MCP:研究(服务器)
该项目是由 MCP:用Anthropic构建丰富的上下文AI应用程序.
它演示了如何使用模型上下文协议(MCP)构建AI应用程序,这些应用程序可以以标准化的方式访问外部来源的工具、数据和提示。
对于客户端,请参阅 mcp研究客户.
概述
模型上下文协议(MCP)是Anthropic开发的一种开放协议,它规范了大型语言模型(LLM)访问外部工具和数据的方式。MCP使用客户端-服务器架构,可以轻松集成新工具并连接到外部系统,如arXiv、GitHub、Google Docs或本地文件。
该项目提供了一个MCP服务器,该服务器公开了从arXiv搜索和检索学术论文的工具和资源,以及LLM的提示模板。
特性
- 标准化工具访问: 公开用于搜索arXiv和提取纸张信息的工具。
- 资源端点: 提供用于列出可用主题和检索详细论文信息的资源。
- 提示模板: 为法学硕士综合和总结研究课题提供提示。
- 客户端-服务器体系结构: 使用来自的FastMCP服务器构建
mcpPython包。 - Docker和Procfile支持: 已准备好在各种环境中部署。
项目结构
.
├── research_server.py # MCP server exposing tools/resources/prompts
├── pyproject.toml # Project metadata and dependencies
├── Dockerfile # Containerization support
├── Procfile # For deployment (e.g., Heroku)
├── uv.lock # Dependency lock file
├── .python-version # Python version specifier
├── .gitignore
└── README.md
入门指南
先决条件
- Python 3.11.11
- 紫外线 (用于依赖关系管理)
- Docker(可选,用于容器化部署)
安装
-
克隆此存储库:
git clone git@github.com:rubychi/mcp-research-server.git -
创建虚拟环境:
uv venv .venv -
激活环境:
source .venv/bin/activate -
运行MCP服务器:
python research_server.py默认情况下,服务器将在端口8001上启动(或使用
PORT环境变量)。 -
(可选)使用Docker运行:
docker build -t mcp-research . docker run -p 8001:8001 mcp-research
用法
-
将MCP服务器用作MCP兼容客户端的后端(例如,Claude Desktop、MCP Inspector或您自己的客户端)。
-
服务器公开了以下工具和资源:
search_papers(topic, max_results):在arXiv上搜索某个主题的论文。extract_info(paper_id):检索特定论文的详细信息。papers://folders:列出所有可用的研究主题。papers://{topic}:获取特定主题论文的详细信息。generate_search_prompt(topic, num_papers):为法学硕士综合研究提供提示。
-
纸张数据存储在
papers/目录,这是在您使用工具时自动创建的。
配置
- 服务器端口可以通过设置
PORT环境变量。 - 基本使用不需要额外的配置。