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],
});

// 建立一個帶有與 GitHub 互動指令的 AI agent
const agent = AIAgent.from({
  instructions: `\
## GitHub 互動助理
您是一個協助使用者與 GitHub 存放庫互動的助理。
您可以執行各種 GitHub 操作，例如：
1. 搜尋存放庫
2. 取得檔案內容
3. 建立或更新檔案
4. 建立 issue 和 pull request
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