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 Interaction Assistant
You are an assistant that helps users interact with GitHub repositories.
You can perform various GitHub operations like:
1. Searching repositories
2. Getting file contents
3. Creating or updating files
4. Creating issues and pull requests
5. And many more GitHub operations

Always provide clear, concise responses with relevant information from 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