Basic MCP Application

Basic MCP Application

site icon
2025.03.26 3
PythonAI交互论文搜索开发工具开发效率内容生成
MCP是一个基于FastAPI和Gadio的简单应用,展示了如何使用模型上下文协议(MCP)与AI模型进行交互。该项目提供了一个简单的聊天界面,用户可以通过该界面与AI模型进行交流,并支持科学论文搜索和分析功能。
View on GitHub

Overview

基本能力

产品定位

MCP是一个演示如何使用模型上下文协议(MCP)与AI模型交互的简单应用,适合开发者和研究人员快速了解MCP的功能和应用场景。

核心功能

  • 科学论文搜索(使用Semantic Scholar API)
  • 论文分析工具
  • 简单的聊天界面
  • 快速安装和设置

适用场景

  • 开发者学习和测试MCP协议
  • 研究人员快速搜索和分析科学论文
  • 需要与AI模型进行简单交互的用户

工具列表

  • FastAPI:后端框架,提供API服务
  • Gradio:前端界面,提供用户交互
  • Google Gemini API:AI模型集成
  • Semantic Scholar API:科学论文搜索

常见问题解答

  • 引用工具问题:当前引用工具可能无法正常工作,正在修复中。
  • API速率限制:Semantic Scholar API有速率限制,可能导致搜索功能偶尔返回错误。

使用教程

使用依赖

  • Python 3.11或更新版本
  • pip或uv包管理器

安装教程

  1. 克隆项目: bash git clone https://github.com/yourusername/basic-mcp-app.git cd basic-mcp-app
  2. 创建虚拟环境: bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
  3. 安装依赖:
  4. 使用pip: bash pip install -r requirements.txt
  5. 使用uv: bash curl -LsSf https://astral.sh/uv/install.sh | sh uv pip install -r requirements.txt
  6. 设置API密钥: bash cp .env.example .env # 在.env文件中添加API密钥
  7. 启动服务: bash python run.py

调试方式

  • 单独启动后端: bash uvicorn backend.main:app --reload
  • 单独启动前端: bash python frontend/app.py
  • 访问前端界面:http://localhost:8501

许可证

该项目遵循 MIT 开源许可条款。