MCP GitHub

direction: down

User: {
  shape: c4-person
}

AIGNE-Framework: {
  label: "AIGNE 框架"
  shape: rectangle

  AIAgent: {
    label: "AI Agent\n(@aigne/core)"
    shape: rectangle
  }

  MCPAgent: {
    label: "GitHub MCP Agent\n(技能)"
    shape: rectangle
  }

  AIAgent -> MCPAgent: "使用技能"
}

GitHub-MCP-Server: {
  label: "GitHub MCP 服务器\n(@modelcontextprotocol/server-github)"
  shape: rectangle
}

GitHub-API: {
  label: "GitHub API"
  shape: cylinder
}

AI-Model-Provider: {
  label: "AI 模型提供商\n(例如 OpenAI, AIGNE Hub)"
  shape: cylinder
}

AIGNE-Observe: {
  label: "AIGNE Observe\n(调试 UI)"
  shape: rectangle
}

User -> AIGNE-Framework.AIAgent: "1. 自然语言请求"
AIGNE-Framework.AIAgent -> AI-Model-Provider: "2. 处理请求"
AI-Model-Provider -> AIGNE-Framework.AIAgent: "3. 返回函数调用"
AIGNE-Framework.AIAgent -> AIGNE-Framework.MCPAgent: "4. 执行函数调用"
AIGNE-Framework.MCPAgent -> GitHub-MCP-Server: "5. 发送命令"
GitHub-MCP-Server -> GitHub-API: "6. 调用 GitHub API"
GitHub-API -> GitHub-MCP-Server: "7. 返回 API 响应"
GitHub-MCP-Server -> AIGNE-Framework.MCPAgent: "8. 返回结果"
AIGNE-Framework.MCPAgent -> AIGNE-Framework.AIAgent: "9. 返回结果"
AIGNE-Framework.AIAgent -> AI-Model-Provider: "10. 处理结果"
AI-Model-Provider -> AIGNE-Framework.AIAgent: "11. 返回自然语言响应"
AIGNE-Framework.AIAgent -> User: "12. 最终响应"
AIGNE-Framework -> AIGNE-Observe: "发送执行追踪"

export GITHUB_TOKEN=YOUR_GITHUB_TOKEN

npx -y @aigne/example-mcp-github

export OPENAI_API_KEY="YOUR_OPENAI_API_KEY"

git clone https://github.com/AIGNE-io/aigne-framework

cd aigne-framework/examples/mcp-github
pnpm install

pnpm start

pnpm start -- --interactive

echo "Search for repositories related to 'modelcontextprotocol'" | pnpm start

import { AIAgent, AIGNE, MCPAgent } from "@aigne/core";
import { OpenAIChatModel } from "@aigne/core/models/openai-chat-model.js";

// 加载环境变量
const { OPENAI_API_KEY, GITHUB_TOKEN } = process.env;

// 初始化 OpenAI 模型
const model = new OpenAIChatModel({
  apiKey: OPENAI_API_KEY,
});

// 初始化 GitHub MCP agent
const githubMCPAgent = await MCPAgent.from({
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-github"],
  env: {
    GITHUB_TOKEN,
  },
});

// 使用模型和 GitHub 技能创建 AIGNE 实例
const aigne = new AIGNE({
  model,
  skills: [githubMCPAgent],
});

// 创建一个 AI agent，并附带与 GitHub 交互的指令
const agent = AIAgent.from({
  instructions: `\
## GitHub 交互助手
你是一个帮助用户与 GitHub 仓库交互的助手。
你可以执行各种 GitHub 操作，例如：
1. 搜索仓库
2. 获取文件内容
3. 创建或更新文件
4. 创建 Issue 和拉取请求
5. 以及许多其他的 GitHub 操作

始终提供清晰、简洁的响应，并附带来自 GitHub 的相关信息。
`,
});

// 调用 agent 搜索仓库
const result = await aigne.invoke(
  agent,
  "Search for repositories related to 'modelcontextprotocol'",
);

console.log(result);
// 预期输出：
// I found several repositories related to 'modelcontextprotocol':
//
// 1. **modelcontextprotocol/servers** - MCP servers for various APIs and services
// 2. **modelcontextprotocol/modelcontextprotocol** - The main ModelContextProtocol repository
// ...

// 完成后关闭 AIGNE 实例
await aigne.shutdown();

aigne observe