duyet-mcp-server

An experimental MCP (Model Context Protocol) server that helps AI assistants connect to and retrieve information about duyet. This server provides access to information primarily available at https://duyet.net, making it available directly to your AI assistant.

Endpoint: `https://mcp.duyet.net/mcp` (Streamable HTTP, stateless — works with every major MCP client)

Connect from Any MCP Client

mcp-remote proxy config (for stdio-only clients)

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

About This Project

This is a study, demo, and experimental project designed to explore MCP capabilities. The project serves as a learning exercise in building remote MCP servers and is mostly written by LLM as well.

Purpose: Enable AI assistants to access and retrieve information about duyet's work, projects, and content that would otherwise require manual web browsing.

Deploy to Cloudflare Workers

This will deploy your MCP server to a URL like: `duyet-mcp-server..workers.dev/sse`

Alternatively, you can clone and deploy using the command line:

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

Customizing Your MCP Server

To add your own tools to the MCP server, define each tool inside the `init()` method of `src/index.ts` using `this.server.tool(...)`.

Connect to Cloudflare AI Playground

You can test your MCP server using the Cloudflare AI Playground:

1. Go to https://playground.ai.cloudflare.com/

2. Enter your deployed MCP server URL (`duyet-mcp-server..workers.dev/sse` or `duyet-mcp-server..workers.dev/mcp`)

3. You can now use the duyet information tools directly from the playground!

Connect Claude Desktop to Your MCP Server

You can connect to your remote MCP server from Claude Desktop using the mcp-remote proxy.

To connect from Claude Desktop, follow Anthropic's Quickstart and go to Settings > Developer > Edit Config.

Update with this configuration:

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

You should see the duyet-mcp information tools become available.

Available Resources and Tools

This MCP server exposes both Resources (read-only data access via URIs) and Tools (interactive functions with parameters). Resources are automatically discovered by Claude Chat for natural conversation flow, while tools are used for actions that require user input.

Resources

Resources provide read-only access to information through URI-based requests. These are automatically discoverable by Claude Chat.

Core Information Resources

• `duyet://about` - Basic information about Duyet with dynamically calculated years of experience
• `duyet://cv/{format}` - CV/resume with format parameters:
  • `duyet://cv/summary` - Brief CV overview
  • `duyet://cv/detailed` - Comprehensive CV information
  • `duyet://cv/json` - Structured CV data (when available)

Content Resources

• `duyet://blog/posts/{limit}` - Latest blog posts from Duyet's technical blog
  • `duyet://blog/posts/1` - Latest blog post
  • `duyet://blog/posts/5` - Latest 5 blog posts (limit: 1-10)
• `duyet://github-activity` - Recent GitHub contributions and activity

Tools

Tools provide interactive functionality with input parameters and side effects.

Core Information Tools

• `get_cv` - Retrieve Duyet's CV (curriculum vitae) in different formats - summary, detailed, or JSON format
• `get_about_duyet` - Get basic information about Duyet including experience, skills, and contact links

Content Tools

• `get_blog_posts` - Get a list of blog posts from blog.duyet.net in JSON format (1-20 posts)
• `get_blog_post_content` - Get the full content of a specific blog post by URL, including title, content, and metadata (author, publish date, tags)
• `get_github_activity` - Retrieve Duyet's recent GitHub activity including commits, issues, pull requests, releases, and other public events. View up to 20 recent activities with optional detailed information

Interaction Tools

• `send_message` - Send a message to Duyet for collaboration, job opportunities, consulting, or general inquiries. Messages are saved with a reference ID for follow-up
• `hire_me` - Get information about hiring Duyet for various roles - full-time, contract, consulting, or part-time positions. Includes expertise, experience, and next steps
• `say_hi` - Send a friendly greeting to Duyet with an optional personal message. Get contact information and connection links

Management Tools

• `contact_analytics` - Generate analytics reports on contact submissions including summary statistics, purpose breakdown, daily trends, and recent activity patterns

Claude Chat Examples

Here are examples of natural conversation flows using this MCP server:

Learning About Duyet

Hiring and Collaboration

Technical Research

Natural Discovery Pattern

The key advantage of this MCP server design is that Claude Chat can naturally discover and reference information through resources, making conversations more fluid:

1. Information Questions → Automatic Resource Access

2. Action Requests → Interactive Tools

3. Progressive Disclosure

Architecture

• Framework: Hono.js running on Cloudflare Workers
• Database: Cloudflare D1 with Drizzle ORM
• Testing: Jest with comprehensive test coverage
• Linting: Biome for code quality
• Type Safety: TypeScript with strict configuration

License

MIT License - see LICENSE file for details.