使用说明
mcp项目
MCP项目存储库托管MCP服务器和客户端演示的源代码。
工作流程概述
系统架构
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Claude Desktop │ │ MCP Inspector │ │ Research │
│ │◄──►│ │◄──►│ Server │
│ - Chat Client │ │ - Debug Tool │ │ - arXiv API │
│ - MCP Client │ │ - Test Server │ │ - File Storage │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Configuration │ │ Network │ │ Local Files │
│ │ │ │ │ │
│claude_desktop_ │ │ HTTP/STDIO │ │ papers/ │
│config.json │ │ Transport │ │ ├─topic/ │
└─────────────────┘ └─────────────────┘ │ └─papers.json │
└─────────────────┘
论文搜索工作流程
User Query ──► Claude Desktop ──► MCP Server ──► arXiv API
│ │ │ │
│ │ │ ▼
│ │ │ Search Results
│ │ │ │
│ │ │ ▼
│ │ ▼ Parse Papers
│ │ Store Locally │
│ │ │ │
│ │ ▼ ▼
│ ▼ papers/topic/ JSON Format
▼ Response papers.json │
Results ◄─────────────────────────────────────────┘
设置MCP演示的步骤
步骤1：开发环境设置
这个项目需要Python 3.8或更高版本。你可以下载Python 这里 对于Windows。首先，你需要安装uv和nodejs。第二，创造 .venv python环境。
cd mcp_project
uv init
uv venv
.venv\Scripts\activate
uv add mcp arxiv anthropic python-dotenv nest_asyncio
我们使用以下命令在macOS中激活venv。
source ./venv/bin/activate
第三，MCP Inspector是一个用于测试和调试MCP服务器的交互式开发工具。通过以下命令运行检查器。
npx @modelcontextprotocol/inspector uv run research_server.py
步骤2:云桌面设置
要安装Claude Desktop，请阅读 沙发支持. 然后，将claude_desktop_config.json复制到Windows：
%APPDATA%\Claude\claude_desktop_config.json
或者将claude_desktop_config.json复制到macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
戈查： 如果Cluse Desktop没有“开发人员菜单”项，请导航到“帮助”>“疑难解答”。然后，选择启用开发人员模式。
开发工作流程
开发设置流程
Start Here
│
▼
┌─────────────────┐
│ Install Python │
│ (3.8+) │
└─────┬───────────┘
│
▼
┌─────────────────┐
│ Install uv & │
│ Node.js │
└─────┬───────────┘
│
▼
┌─────────────────┐
│ Create Virtual │
│ Environment │
│ (.venv) │
└─────┬───────────┘
│
▼
┌─────────────────┐
│ Install MCP │
│ Dependencies │
│(mcp, arxiv...) │
└─────┬───────────┘
│
▼
┌─────────────────┐
│ Test Server │
│ with Inspector │
└─────┬───────────┘
│
▼
┌─────────────────┐
│ Configure │
│ Claude Desktop │
└─────────────────┘
