Cloud Computing MCP Server

云计算MCP服务器

用于管理和查询云计算课程材料的模型上下文协议（MCP）服务器。该服务器通过人工智能工具提供对课堂讲稿、教程、家庭作业和过去论文的智能访问。

📚 特性

• 搜索所有材料：在讲座、教程、家庭作业和过去的论文中进行全文搜索
• 基于周的组织：检索任何特定周的所有材料（1-13）
• 过去的论文访问：快速访问过去一年的所有试卷
• 课程概述：获取可用材料的完整概述
• 人工智能学习助手：内置学习和考试准备提示
• 资源访问：按路径直接访问任何文档

🚀 快速开始

先决条件

• Node.js 17或更高版本
• npm

安装

1. 克隆或导航到此目录
2. 安装依赖项：

npm install

1. 构建项目：

npm run build

添加课程材料

将您的材料放入 materials/ 目录遵循此结构：

materials/
├── lectures/week-1/          # Week 1 lecture notes
├── lectures/week-2/          # Week 2 lecture notes
├── ...
├── tutorials/week-1/         # Week 1 tutorial questions
├── tutorial-answers/week-1/  # Week 1 tutorial answers
├── homework/week-1/          # Week 1 homework
├── homework-answers/week-1/  # Week 1 homework answers
└── past-papers/              # Past year papers by year (2015-2024)
    ├── 2015/
    ├── 2016/
    ├── ...
    ├── 2023/
    └── 2024/

支持的文件格式：

• Markdown（.md）
• 文本（.txt）
• PDF（.PDF）
• 任何基于文本的格式

示例：添加第1周的材料

# Add lecture notes
cp ~/Downloads/week1-lecture.pdf materials/lectures/week-1/

# Add tutorial
cp ~/Downloads/week1-tutorial.md materials/tutorials/week-1/

# Add tutorial answers
cp ~/Downloads/week1-answers.md materials/tutorial-answers/week-1/

# Add past papers by year
cp ~/Downloads/2023-midterm.pdf materials/past-papers/2023/
cp ~/Downloads/2023-final.pdf materials/past-papers/2023/
cp ~/Downloads/2024-exam.pdf materials/past-papers/2024/

🔧 使用服务器

使用VS代码GitHub副本（推荐）

1. 打开VS代码命令面板(Cmd+Shift+P 在macOS上， Ctrl+Shift+P 在Windows/Linux上）
2. 键入并选择： “MCP：打开用户配置”
3. 将此配置添加到您的 mcp.json:

{
  "mcpServers": {
    "cloud-computing": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/Cloud Computing MCP Server/build/index.js"]
    }
  }
}

替换 /ABSOLUTE/PATH/TO/ 此目录的实际路径。

1. 保存文件并重新启动VS Code或GitHub Copilot

备注：MCP配置文件位于：

• macOS/Linux: ~/.vscode/mcp.json
• 视窗: %USERPROFILE%\.vscode\mcp.json

使用克劳德桌面（替代）

如果您更喜欢Claude Desktop，请添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上：

{
  "mcpServers": {
    "cloud-computing": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/Cloud Computing MCP Server/build/index.js"]
    }
  }
}

配备MCP检查员（用于测试）

npx @modelcontextprotocol/inspector node build/index.js

🛠️ 可用工具

1. search-materials

按内容或文件名搜索所有课程材料。

参数：

• query （string）：搜索词
• materialType （可选）：按类型筛选(lectures, tutorials, tutorialAnswers, homework, homeworkAnswers, pastPapers，或 all)

例子：

Search for "virtualization" in all materials
Search for "docker" in lectures only

2. get-week-materials

检索特定周的所有材料。

参数：

• week （数字）：周数（1-13）
• materialType：材料类型(lectures, tutorials, tutorialAnswers, homework, homeworkAnswers)

例子：

Get lecture notes for week 5
Get tutorial answers for week 3

3. list-past-papers

按年份列出所有可用的过去一年的试卷（2015-2024）。

参数：

• year （可选）：按特定年份筛选

例子：

Show me all past papers
List past papers for 2023

4. get-year-papers

获取特定年份的所有过去论文。

参数：

• year （编号）：检索论文的年份（2015-2024）

例子：

Get all papers from 2024
Show me 2023 exam papers

5. get-course-overview

获取所有可用课程材料的概述。

例子：

Give me an overview of the course

💬 内置提示

学习一周

一个有指导的提示，帮助你学习特定一周的材料。

AI聊天中的示例用法：

/study-week week=5 focusArea="containerization"

考试准备

一个全面的提示，帮助你为考试做准备。

AI聊天中的示例用法：

/exam-prep topics="cloud architecture, virtualization, docker"

📖 资源

服务器还将文档作为可以直接引用的资源公开：

• cloudcomputing://document/{path} -按相对路径访问任何文档

🔍 示例工作流程

第三周学习

1. 问你的人工智能助理：“帮我学习第3周”
2. AI将使用 get-week-materials 检索讲座、教程和答案
3. 就具体概念提出后续问题

搜索主题

1. 问：“查找有关Kubernetes的所有材料”
2. AI将使用 search-materials 查找所有周的相关内容
3. 直接访问相关文件

考试准备

1. 使用 /exam-prep 提示或提问：“帮我准备云计算考试”
2. AI将：

- 列出所有过去的论文 - 搜索关键概念 - 帮助您练习问题 - 制定学习计划

🏗️ 发展

项目结构

.
├── src/
│   └── index.ts          # Main MCP server implementation
├── materials/            # Your course materials
│   ├── lectures/
│   ├── tutorials/
│   ├── tutorial-answers/
│   ├── homework/
│   ├── homework-answers/
│   └── past-papers/
├── build/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

进行更改

1. 编辑 src/index.ts
2. 重建： npm run build
3. 重新启动MCP客户端以获取更改

观看模式（用于开发）

npm run dev

当您对源代码进行更改时，这将自动重建。

🎓 考试准备技巧

1. 整理你的材料：按周整理材料，便于检索
2. 使用描述性文件名：清楚地命名文件（例如。， week3-docker-containers.md)
3. 与AI结合：让人工智能对你进行测验、解释概念或创建学习指南
4. 高效搜索：使用特定术语查找所有周的相关材料
5. 练习过去的论文：使用 list-past-papers 用于访问以前考试的工具

🔒 隐私

所有材料都存放在您的机器上。MCP服务器仅通过模型上下文协议提供对AI助手的访问。你的课程材料永远不会离开你的电脑。

📝 许可证

麻省理工学院

📦 分布

要创建用于共享的分发包，请执行以下操作：

# Create npm package
npm pack

# This creates cloud-computing-mcp-server-1.0.0.tgz
# Share this file with others who can install it with:
# npm install -g cloud-computing-mcp-server-1.0.0.tgz

🤝 贡献

这是一个个人学习工具，但可以根据自己的需要自由定制！

🆘 故障排除

服务器无法启动

• 确保你已经跑过了 npm install 和 npm run build
• 检查Node.js版本是否为17或更高： node --version

材料未显示

• 验证文件是否在正确的目录结构中
• 检查文件权限（文件必须可读）
• 尝试使用 get-course-overview 工具查看检测到的内容

搜索未找到内容

• 确保文件是基于文本的（不是没有文本层的二进制PDF）
• 检查文件编码（应为UTF-8）
• 尝试从文档中搜索精确的单词

📚 示例材料模板

看 materials/lectures/week-1/lecture-notes.md 获取如何构建内容的模板。

______________________________________________________________________

快乐学习！ 🎓 使用此工具在云计算考试中取得优异成绩！