Data Engineering Tutor MCP Server

数据工程导师MCP服务器

此仓库包含一个使用Node.js和TypeScript构建的简单模型上下文协议（MCP）服务器。它充当“数据工程导师”，为连接的AI客户端提供有关数据工程概念、模式和技术的个性化更新。

此服务器演示了MCP的关键概念：定义 资源, 工具，以及 鼓励 创建一个有状态的交互式代理助手。

先决条件

• Node.js（建议使用v18或更高版本）
• npm （或者你喜欢的Node.js包管理器，比如 yarn 或 pnpm)
• 能够连接到MCP服务器的AI客户端（例如Cursor、Claude桌面应用程序）
• 一 OpenRouter API密钥 （用于通过困惑获取实时数据工程更新）

设置

1. 克隆存储库：

   # If you haven't already
   # git clone 
   # cd 

1. 安装依赖关系：

   npm install

1. 准备API密钥： 这 de_tutor_get_updates 工具需要一个OpenRouter API密钥。

- 从以下位置获取密钥 OpenRouter 的. - 创建一个 .env 项目根目录中的文件（您可以复制 .env.example). - 将您的密钥添加到 .env 文件：

     OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxxxxxxxxxxxx

_（将占位符替换为您的实际密钥。）_

1. 构建服务器： 编译TypeScript代码。

   npm run build

运行服务器

您可以直接使用Node运行服务器：

node build/index.js

或者，配置您的MCP客户端（如Cursor或Claude桌面应用程序）以启动服务器。服务器名称为 de-tutor 二进制名称（如果客户端配置需要）也是 de-tutor.

客户端配置示例（例如，用于Claude Desktop）：

{
  "mcpServers": {
    "de-tutor": {
      "command": "node",
      "args": ["/full/path/to/your/project/build/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-xxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

_（确保路径 args 是正确的吗 绝对路径 到建成 index.js 您系统上的文件。你可能不需要 env 如果您已经在使用 .env 文件，因为服务器直接通过以下方式加载它 dotenv.)_

与光标一起使用

光标 是一个AI优先的代码编辑器，可以充当MCP客户端。使用Cursor设置此服务器需要配置服务器启动，并可能为指导提示设置项目规则，尽管Cursor也可能会选择服务器提供的提示。

1. 在游标中配置服务器：

- 首选 Cursor Settings > MCP > Add new global MCP server. - 粘贴与上述示例客户端配置相同的JSON，确保路径 build/index.js 适用于您的系统。

1. （可选）为提示创建游标项目规则： 如果你更喜欢明确的规则，或者发现Cursor没有自动使用服务器的提示，你可以使用Cursor的 项目规则 功能。

- 创建目录 .cursor/rules 如果它不存在，请在项目根目录中。

- 在其中创建一个名为的文件 de-tutor.rule （或任何 .rule 文件名）。

- 将以下指导文本粘贴到 de-tutor.rule:

     You are a helpful assistant connecting to a Data Engineering knowledge server. Your goal is to provide the user with personalized updates about new Data Engineering concepts, patterns, and technologies they haven't encountered yet.

     Available Tools:
     1.  `de_tutor_get_updates`: Fetches recent general news and articles about Data Engineering. Use this first to see what's new.
     2.  `de_tutor_read_memory`: Checks which Data Engineering concepts the user already knows based on their stored knowledge profile.
     3.  `de_tutor_write_memory`: Updates the user's profile to mark whether they have learned or already know a specific Data Engineering concept mentioned in an update.

     Your Workflow:
     1.  Call `de_tutor_get_updates` to discover recent Data Engineering developments.
     2.  Call `de_tutor_read_memory` to understand the user's current knowledge base.
     3.  Present the new developments to the user, highlighting things they likely don't know.
     4.  If the user confirms they know a concept or have learned it, call `de_tutor_write_memory` to update their profile.

     Be concise and focus on delivering relevant, new information tailored to the user's existing knowledge.

1. 连接和使用：

- 确保 de-tutor 服务器已在Cursor的MCP设置中启用。 - 如果使用规则文件：启动新的聊天或代码生成请求（例如Cmd+K），并包括 @de-tutor-rule （或您命名的规则文件）。这个命令告诉Cursor加载规则的内容，并提供如何使用工具的说明。 - 如果依赖服务器提示：只需开始与Cursor交互；它应该可以访问服务器提供的工具和指导提示。

功能和用途

此服务器提供以下功能：

• 资源(data_engineering_knowledge_memory): 在中存储一个简单的JSON对象 data/data-engineering-knowledge.json 将已知概念（字符串）映射到布尔标志(true).
• 工具：

- de_tutor_read_memory：从JSON文件中读取当前已知的概念。 - de_tutor_write_memory：更新JSON文件以将概念标记为已知(true)或未知(false).拿 concept （字符串）和 known （boolean）作为输入。 - de_tutor_get_updates：使用OpenRouter API密钥查询困惑(perplexity/sonar-small-online)了解最新的数据工程新闻、模式和技术。

• 提示(data-engineering-tutor-guidance): 向连接的AI客户端提供有关如何在工作流中使用工具的说明：

1. 获取最新更新。 1. 从记忆中读取已知概念。 1. 向用户呈现新信息。 1. 根据用户反馈更新内存。

开发与调试

• 构建： npm run build 将TypeScript编译为JavaScript build/ 目录。
• 代码结构： 看 src/ 有关实施细节：

- src/index.ts：服务器入口点。进口 McpServer 和 StdioServerTransport 从特定的SDK路径。实例化 McpServer.导入和调用注册功能(registerPrompts, registerResources, registerTools)从其他模块传递服务器实例。使用设置和连接服务器 StdioServerTransport. - src/prompts/index.ts：定义指导提示文本。出口 registerPrompts，这需要 McpServer 实例和用途 server.prompt() 将静态引导提示注册到其回调中。 - src/resources/index.ts：出口 KnowledgeMemory 类型和辅助函数(readMemoryFile, writeMemoryFile)用于文件I/O data/data-engineering-knowledge.json.出口 registerResources，这需要 McpServer 实例和用途 server.resource() 注册 data_engineering_knowledge_memory 具有特定URI和 ReadResourceCallback. - src/tools/index.ts：出口 registerTools，这需要 McpServer 实例和用途 server.tool() 注册每个工具(de_tutor_read_memory, de_tutor_write_memory, de_tutor_get_updates).必要时使用Zod定义输入模式（用于 write_memory).工具函数使用来自的助手 resources/index.ts 或 fetch 执行操作并以预期格式返回结果。

• MCP检查员： 使用 @modelcontextprotocol/inspector 查看原始消息流：

  npx @modelcontextprotocol/inspector node ./build/index.js

_（确保 OPENROUTER_API_KEY 如果以这种方式运行并且不完全依赖于 .env 服务器本身加载的文件。)_

备注

• 此服务器使用一个简单的文件(data/data-engineering-knowledge.json)用于存储用户知识。对于更健壮的应用程序，请考虑使用合适的数据库。
• 错误处理是基本的；生产服务器将需要更全面的错误管理。

总结

此演示演示了使用TypeScript SDK和 McpServer 类。我们定义了管理状态的资源、执行操作的工具（包括与外部API交互），以及指导AI客户端的提示。

这为使用MCP构建更复杂、更有用的代理功能奠定了基础。

（另外，如果你遇到任何🐛bug，请随时提出问题。）