Duyet MCP Server

🚀 duyet-mcp-server

这是一个实验性的 MCP (模型上下文协议) 服务器，可帮助AI助手连接并获取有关duyet的信息。该服务器主要提供 https://duyet.net 上的信息，让你的AI助手能够直接访问这些内容。

🚀 快速开始

使用方法：在你的AI助手中更新MCP服务器配置：

{
  "mcpServers": {
    "duyet-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.duyet.net/sse"
      ]
    }
  }
}

如果你使用的是Claude Code：

claude mcp add --transport http duyet https://mcp.duyet.net/mcp

端点：

• https://mcp.duyet.net/sse
• https://mcp.duyet.net/mcp

✨ 主要特性

• 这是一个研究、演示和实验项目，旨在探索MCP的能力。该项目是构建远程MCP服务器的学习实践，大部分代码由大语言模型生成。
• 目的是让AI助手能够访问和检索有关duyet的工作、项目和内容的信息，而无需手动浏览网页。

📦 安装指南

部署到Cloudflare Workers

这将把你的MCP服务器部署到类似如下的URL：duyet-mcp-server.<your-account>.workers.dev/sse

或者，你可以通过命令行克隆并部署：

git clone https://github.com/duyet/duyet-mcp-server
cd duyet-mcp-server
npm install
npm run deploy

💻 使用示例

基础用法

{
  "mcpServers": {
    "duyet-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.duyet.net/sse"
      ]
    }
  }
}

高级用法

如果你使用Claude Code，可以通过以下命令添加MCP服务器：

claude mcp add --transport http duyet https://mcp.duyet.net/mcp

📚 详细文档

自定义MCP服务器

要向MCP服务器添加你自己的工具，可以在 src/index.ts 的 init() 方法中使用 this.server.tool(...) 来定义每个工具。

连接到Cloudflare AI Playground

你可以使用Cloudflare AI Playground测试你的MCP服务器：

1. 访问 https://playground.ai.cloudflare.com/
2. 输入你部署的MCP服务器URL (duyet-mcp-server.<your-account>.workers.dev/sse 或 duyet-mcp-server.<your-account>.workers.dev/mcp)
3. 现在你可以直接在Playground中使用duyet信息工具！

从Claude Desktop连接到MCP服务器

你可以使用 mcp-remote代理 从Claude Desktop连接到你的远程MCP服务器。 要从Claude Desktop连接，请遵循 Anthropic的快速入门指南，然后转到设置 > 开发者 > 编辑配置。 使用以下配置进行更新：

{
  "mcpServers": {
    "duyet-info": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://duyet-mcp-server.<your-account>.workers.dev/sse"
      ]
    }
  }
}

你应该会看到duyet-mcp信息工具可用。

可用资源和工具

这个MCP服务器提供了资源（通过URI进行只读数据访问）和工具（带有参数的交互式函数）。Claude Chat可以自动发现资源，以实现自然的对话流程，而工具则用于需要用户输入的操作。

资源

资源通过基于URI的请求提供对信息的只读访问。Claude Chat可以自动发现这些资源。

• 核心信息资源
  • duyet://about - 关于Duyet的基本信息，包括动态计算的工作经验年限
  • duyet://cv/{format} - 简历，带有格式参数：
    • duyet://cv/summary - 简历简要概述
    • duyet://cv/detailed - 简历详细信息
    • duyet://cv/json - 结构化的简历数据（如果可用）
• 内容资源
  • duyet://blog/posts/{limit} - Duyet技术博客的最新文章
    • duyet://blog/posts/1 - 最新文章
    • duyet://blog/posts/5 - 最新5篇文章（限制：1 - 10）
  • duyet://github-activity - 最近的GitHub贡献和活动

工具

工具提供带有输入参数和副作用的交互式功能。

• send_message - 向Duyet发送消息，用于合作、工作机会、咨询或一般询问。消息将保存一个参考ID以便跟进
• get_cv - 以不同格式（摘要、详细或JSON格式）检索Duyet的简历
• get_github_activity - 检索Duyet最近的GitHub活动，包括提交、问题、拉取请求、版本发布和其他公共事件。最多可查看20条最近的活动，并可选择查看详细信息
• hire_me - 获取有关聘请Duyet担任各种职位（全职、合同工、顾问或兼职）的信息。包括专业技能、经验和后续步骤
• say_hi - 向Duyet发送友好问候，并可选择附带个人消息。获取联系信息和连接链接
• contact_analytics - 生成关于联系人提交的分析报告，包括汇总统计、目的分类、每日趋势和最近的活动模式

Claude Chat示例

以下是使用此MCP服务器的自然对话流程示例：

了解Duyet

用户：Duyet是谁，他是做什么的？

Claude：[自动访问duyet://about资源]
Duyet是一名有8年经验的数据工程师。他对数据工程概念、最佳实践以及最新的数据和云技术充满信心。你可以访问他的博客 https://blog.duyet.net，查看他的简历 https://duyet.net/cv，以及他的项目 https://github.com/duyet。

用户：他最近在写什么？

Claude：[自动访问duyet://blog/posts/3资源]
他最近的博客文章涵盖了数据工程、云技术和分布式系统等主题。你想了解某篇特定文章的更多细节吗？

用户：他目前正在从事什么工作？

Claude：[自动访问duyet://github-activity资源]
根据他最近的GitHub活动，Duyet一直在从事MCP服务器实现、数据管道项目，并为数据工程的开源工具做出贡献。

招聘与合作

用户：我正在寻找一名数据工程师。你能帮我联系Duyet吗？

Claude：我可以使用send_message工具帮你向Duyet发送消息。这是什么类型的机会？

用户：这是我们初创公司的一个全职职位，需要使用Kafka和Spark。

Claude：[使用send_message工具]
你想在给Duyet的消息中说些什么？我会确保说明这是一个使用Kafka和Spark技术的全职职位。

用户：嗨，Duyet，我们是一家A轮融资的初创公司，正在构建实时数据平台。我们很想讨论一个高级数据工程师的职位，涉及Kafka、Spark和云基础设施。这是一个支持远程工作的职位，有具有竞争力的股权。

Claude：[执行send_message工具并发送消息]
你的消息已成功发送！这是你的参考ID：abc-123-def，以便跟进。你可以直接通过 me@duyet.net 联系Duyet，也可以在LinkedIn上找到他：https://linkedin.com/in/duyet，或者在GitHub上查看他的项目：https://github.com/duyet。

技术研究

用户：在面试之前，我想了解Duyet的技术背景。

Claude：[自动访问duyet://cv/detailed资源]
根据Duyet的详细简历，他有8年的数据工程经验，擅长Apache Spark、Kafka、云平台和分布式系统。他的经验包括构建可扩展的数据管道和使用现代数据栈技术。

用户：你能给我展示一些他最近的技术工作吗？

Claude：[自动访问duyet://github-activity资源]
他最近的GitHub活动显示了他对数据工程项目、MCP服务器实现和开源工具的贡献。他一直在积极从事分布式系统和云原生数据解决方案的工作。

用户：他写的内容涉及哪些类型？

Claude：[自动访问duyet://blog/posts/5资源]
他的技术博客涵盖了诸如构建可扩展数据管道、现代数据工程最佳实践、云技术和分布式系统架构等主题。

自然发现模式

这个MCP服务器设计的主要优势在于，Claude Chat可以通过资源自然地发现和引用信息，使对话更加流畅：

1. 信息问题 → 自动资源访问
   • "Duyet是谁？" → duyet://about
   • "他有什么经验？" → duyet://cv/detailed
   • "他在写什么？" → duyet://blog/posts/3
   • "他在做什么工作？" → duyet://github-activity
2. 行动请求 → 交互式工具
   • "我想联系他" → send_message 工具
   • "你能给他发送问候吗？" → say_hi 工具
   • "获取他的简历" → get_cv 工具
3. 逐步披露
   • 从一般性问题开始
   • 深入到具体领域
   • 准备好后采取行动

🔧 技术细节

• 框架：运行在Cloudflare Workers上的Hono.js
• 数据库：使用Drizzle ORM的Cloudflare D1
• 测试：使用Jest进行全面的测试覆盖
• 代码检查：使用Biome进行代码质量检查
• 类型安全：使用严格配置的TypeScript

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。