Claude on Billy's Blog

RAG 技术深度解析：从基础到 GraphRAG，以及大 Context 时代的思考

billychen826@gmail.com (Billy) — Wed, 05 Nov 2025 10:00:00 +0800

RAG 基础原理

什么是 RAG

RAG (Retrieval-Augmented Generation) 检索增强生成，是一种结合了信息检索和大语言模型生成能力的技术范式。其核心思想是：

用户查询 → 检索相关文档 → 将文档作为上下文 → LLM 生成答案

为什么需要 RAG

在 RAG 出现之前，LLM 面临几个核心问题：

知识截止日期：模型训练数据有时效性，无法获取最新信息
幻觉问题：模型可能生成看似合理但实际错误的内容
领域知识局限：对特定领域的深度知识覆盖不足
无法访问私有数据：企业内部文档、数据库无法被预训练模型学习
Context Window 大小受限：Context Window 不足以塞下全部文档内容，用户提问时 window 就塞满了

RAG 的基本架构

┌─────────────┐
│ 文档语料库 │
└──────┬──────┘
 │ 离线处理
 ▼
┌─────────────┐
│ 文档切块 │ (Chunking)
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 向量化 │ (Embedding)
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 向量数据库 │ (Vector DB)
└──────┬──────┘
 │
 │ 在线查询
 │
┌──────┴──────┐
│ 用户查询 │
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 查询向量化 │
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 相似度检索 │ (Top-K)
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 重排序 │ (可选)
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 构建 Prompt │
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ LLM 生成 │
└──────┬──────┘
 │
 ▼
┌─────────────┐
│ 返回答案 │
└─────────────┘

关键技术组件

1. 文档切块 (Chunking)

切块策略直接影响检索质量。

使用Go开发MCP并接入Claude Desktop：go-mcp库实践

billychen826@gmail.com (Billy) — Tue, 08 Apr 2025 15:30:00 +0800

引言

人工智能助手如Claude已经成为我们日常工作的重要工具，但其能力往往受限于预设功能。通过Model Completion Protocol (MCP)，我们可以显著扩展AI助手的能力边界，使其能够执行更多实用的任务。本文将详细介绍如何使用go-mcp开源库在Go语言环境下开发MCP服务，并将其成功接入Claude Desktop，实现与本地应用程序的交互。

MCP协议简介

Model Completion Protocol (MCP)是一个允许AI助手与外部工具进行交互的协议。通过MCP，Claude等AI助手可以：

调用外部工具和API
访问本地系统资源
执行特定的计算任务
获取和处理实时数据

这使得Claude能够突破知识截止日期的限制，获取最新信息，并执行需要额外计算能力或系统访问权限的任务。

go-mcp库介绍

go-mcp是一个基于Go语言的MCP协议实现库，它提供了一套完整的API用于开发MCP服务。使用go-mcp，开发者可以轻松地创建自定义工具，并将这些工具无缝集成到Claude Desktop中。

该库的主要特点包括：

完整实现MCP协议规范
支持HTTP和stdio两种通信方式
灵活的服务端架构
内置请求验证和错误处理
类型安全的API设计

开发环境准备

在开始开发之前，我们需要准备以下环境：

# 安装Go (确保版本至少为1.18)
brew install go

# 克隆go-mcp仓库
git clone https://github.com/virgoC0der/go-mcp.git
cd go-mcp

# 安装依赖
go mod tidy

实现应用启动器MCP服务

参考go-mcp仓库中的examples/app-launcher示例，我们来实现一个应用启动器MCP服务，这个服务将允许Claude Desktop打开本地应用程序。

1. 创建项目结构

mkdir claude-app-launcher
cd claude-app-launcher
go mod init github.com/yourusername/claude-app-launcher

2. 实现服务结构

首先，让我们实现一个满足MCP协议要求的服务结构：

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"os"
	"os/exec"
	"os/signal"
	"runtime"
	"sync"
	"syscall"

	"github.com/virgoC0der/go-mcp"

	"github.com/virgoC0der/go-mcp/internal/types"
	"github.com/virgoC0der/go-mcp/transport"
)

// AppLauncherServer implements the MCP service interface
type AppLauncherServer struct {
	prompts []types.Prompt
	tools []types.Tool
	resources []types.Resource
}

// NewAppLauncherServer creates a new app launcher server instance
func NewAppLauncherServer() *AppLauncherServer {
	s := &AppLauncherServer{
		// 定义支持的提示
		prompts: []types.Prompt{
			{
				Name: "openApp",
				Description: "Open a macOS application",
				Arguments: []types.PromptArgument{
					{
						Name: "appName",
						Description: "Name of the application to open",
						Required: true,
					},
				},
			},
		},
		// 定义支持的工具
		tools: []types.Tool{
			{
				Name: "openApp",
				Description: "Open a macOS application",
				InputSchema: map[string]interface{}{
					"type": "object",
					"properties": map[string]interface{}{
						"appName": map[string]interface{}{
							"type": "string",
							"description": "Name of the application to open",
						},
					},
					"required": []string{"appName"},
				},
			},
		},
		// 定义支持的资源
		resources: []types.Resource{
			{
				URI: "apps",
				Name: "apps",
				Description: "List of common macOS applications",
				MimeType: "application/json",
			},
		},
	}
	return s
}

3. 实现服务接口方法

接下来，我们需要实现MCP服务接口所需的各种方法：

Claude+MCP一键生成博客：AI助力内容创作与自动化部署

billychen826@gmail.com (Billy) — Mon, 31 Mar 2025 10:00:00 +0800

Claude+MCP一键生成博客：AI助力内容创作与自动化部署

在这个信息爆炸的时代，高效地创建和发布内容已成为许多创作者的迫切需求。今天，我想分享一个结合了AI大语言模型Claude和Model Context Protocol (MCP)的强大工作流，它可以让你以惊人的速度从创意到发布完成整个博客创作过程。

工作流概述

这个一键式博客生成和部署流程包含三个主要步骤：

使用Claude生成高质量的博客内容并保存为Markdown文件
通过MCP desktop-commander自动推送到GitHub仓库并触发GitHub Actions
利用MCP playwright自动检查部署结果

这个过程完全自动化，从内容创建到部署验证，几乎不需要人工干预。

配置MCP工具

要开始使用这个工作流，首先需要在Claude客户端中配置MCP工具。步骤如下：

打开Claude客户端
点击Settings -> Developer -> Edit Config
输入以下配置：

{
 "mcpServers": {
 "fileSystme": {
 "command": "npx",
 "args": [
 "-y",
 "@modelcontextprotocol/server-filesystem",
 "YOUR PATH"
 ]
 },
 "playwright": {
 "command": "npx",
 "args": [
 "@playwright/mcp@latest"
 ]
 },
 "desktop-commander": {
 "command": "npx",
 "args": [
 "-y",
 "@smithery/cli@latest",
 "run",
 "@wonderwhy-er/desktop-commander",
 "--key",
 "YOUR PERSONAL KEY"
 ]
 }
 }
}

这个配置告诉Claude如何与三个关键MCP工具通信：