mcp-for-mcv

毕业设计项目 2025

创建者

• Chanatip Kowsurat
• Siriwid Thongon
• Phumsiri Sumativit
• Chanatpakorn Sirintronsopon

---

项目概述

mcp-for-mcv 是一个轻量级的 MyCourseVille MCP（MyCourseVille 控制面板）服务器。它提供了使用 FastMCP 获取课程数据、学生资料和部门信息的工具。

该项目旨在扩展性、性能以及与支持 MCP 的客户端（如 Cursor、Claude 和内部 MCP 检查器）的集成易用性方面进行设计。

特性

• 从 MyCourseVille 获取课程数据
• 获取学生资料
• 访问部门信息
• 使用 FastMCP 构建，以实现高性能和可扩展性
• 支持 MCP 工具、检查器和外部代理

安装

1. 确保安装了 Python 3.10+。

2. 安装 uv

   pip install uv
   

3. 安装依赖项。 您可以单独安装 FastAPI 和 FastMCP：

   uv add fastapi
   uv add fastmcp
   

   或者从 pyproject.toml 安装所有内容：

   uv run
   

4. 启动服务器

   uv run src/server.py
   

   默认 MCP 服务器 URL：

   http://localhost:8000/mcp
   

MCP 检查器

运行 MCP 检查器：

uv run fastmcp dev --ui-port 3000 .\src\server.py

• 选择传输类型：流式 HTTP
• 设置 URI 为您的服务器 URL（默认：http://localhost:8000/mcp）

集成指南

Cursor

1. 按下 Ctrl + P → 搜索：>打开 MCP 设置
2. 点击添加新 MCP 服务器
3. 将以下内容添加到您的 mcp.json 中：

   {
      "mcpServers": {
         "mcv-mcp-server-2123": {
            "command": "npx mcp-remote http://localhost:8000/mcp 6274"
            }
      }
   }
   
   

4. 如果成功，Cursor 将打开一个浏览器窗口以登录 MCV。

Claude (Anthropic)

(TODO — 集成说明将很快添加。)

其他 MCP 客户端

(即将推出。)

工具使用示例

以下是 MCP 工具调用示例，这些示例可以在服务器连接到 MyCourseVille 后由 MCP 客户端（如 Cursor、Claude、MCP 检查器等）使用。

1. 获取用户资料

自然语言示例：

获取我在 MyCourseVille 的用户资料

给我 mcv

示例响应：

{
  "id": "123",
  "display_name": "Siriwid Thongon",
  "student_id": "6530414821",
  "department": "计算机工程",
  "email": "student@example.com"
}

2. 获取所有用户课程

自然语言示例：

列出我所有的 MyCourseVille 课程

显示我这学期的课程

3. 另外

获取课程 ID 的材料
获取公告
检查我的截止日期
检查我的课程导师
获取此课程的大纲
按 ... 排序获取课程

项目结构

mcp-for-mcv/
├── src/
│   ├── server.py
│   ├── controllers/
│   ├── routes/
│   ├── config/
│   └──  auth/
├── .env    
├── README.md
└── ...

贡献

欢迎提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

---

许可证

本项目用于教育目的。