MCP Client

项目简介

本项目是一个基于现代技术栈的MCP Client实例：

• 前端：基于 Nextjs 和 Copilotkit CoAgent
• 后端：基于 LangGraph

安装与运行

前端

1. 安装依赖：

# 安装Copilotkit相关包
pnpm add @copilotkit/react-ui @copilotkit/react-core @copilotkit/runtime

# 安装项目依赖
pnpm install

2. 启动开发服务器：

pnpm dev

3. 关键配置文件 app/api/copilotkit：

import {
    CopilotRuntime,
    copilotRuntimeNextJSAppRouterEndpoint,
    ExperimentalEmptyAdapter
} from "@copilotkit/runtime";
import { NextRequest } from "next/server";

// 可以使用任何服务适配器来支持多代理
const serviceAdapter = new ExperimentalEmptyAdapter();

const runtime = new CopilotRuntime({
    remoteEndpoints: [
        {
            url: "http://localhost:8001/mcp",
        }
    ],
});

export const POST = async (req: NextRequest) => {
    const { handleRequest } = copilotRuntimeNextJSAppRouterEndpoint({
        runtime,
        serviceAdapter,
        endpoint: "/api/copilotkit",
    });

    return handleRequest(req);
};

重要：需要配置 remoteEndpoints，其中 url 指向后端 FastAPI 部署的 LangGraph 服务。

后端

1. 进入后端目录：

cd agent

2. 激活虚拟环境：

source .venv/bin/activate

3. 启动服务器：

uv run fastapi_server.py

功能特点

• 后端可以基于 LangGraph 打造复杂 Agent
• 前后端分离架构，便于扩展和维护
• 支持多代理协作