Easy MCP Use

🚀 MCP-Use-TS

MCP-Use-TS は、TypeScript 用の MCP ライブラリです。このライブラリを使用すると、複数の MCP サーバーを簡単に設定して接続し、プロジェクト内で利用することができます。このライブラリは、Playwright MCP などのさまざまな MCP 実装との統合を簡素化し、ビジネスロジックの実装に集中できるように設計されています。

何か質問や提案があれば、issue または pull request を自由に提出してください。

🚀 クイックスタート

インストール

npm install mcp-use-typscript

プロジェクトの設定

TypeScript プロジェクト内に mcp-config.ts ファイルを作成します。

import type { MCPConfig } from 'mcp-use-typscript';

const config: MCPConfig = {
  servers: [
    {
      name: 'playwright',
      command: 'npx',
      args: ['@playwright/mcp', '--version'],
      options: {
        cwd: '.',
        stdio: 'inherit'
      }
    },
    {
      name: 'airbnb',
      command: 'npx',
      args: ['-y', '@openfb/mcp-server-airbnb']
    }
  ]
};

export default config;

MCP サーバーの起動

プロジェクトのルートディレクトリに start-mcp.ts ファイルを作成します。

import { startMCP } from 'mcp-use-typscript';

async function main() {
  await startMCP();
}

main().catch(console.error);

以下のコマンドを実行して MCP サーバーを起動します。

npm run start-mcp

使用例

TypeScript ファイル内で MCP クライアントとプロキシをインポートして使用します。

import { createMCPClient, createMCPAgent } from 'mcp-use-typscript';

async function main() {
  const client = await createMCPClient();
  const agent = createMCPAgent({
    client,
    llm: new LLM(),
    verbose: true
  });

  const result = await agent.run('你的任务指令');
  console.log(result);
}

main().catch(console.error);

✨ 主な機能

• 複数の MCP サーバーへの同時接続をサポートします。
• 柔軟な設定オプションを提供し、各サーバーの起動パラメータをカスタマイズできます。
• 組み込みのプロキシ機能により、プロジェクト内でさまざまな MCP サービスを管理して使用することが容易です。

📚 ドキュメント

設定ファイルの形式

設定ファイルには以下の内容を含める必要があります。

interface MCPConfig {
  servers: Array<{
    name: string;
    command: string;
    args?: string[];
    options?: Record<string, unknown>;
  }>;
}

プロキシの作成

createMCPAgent 関数を使用してプロキシインスタンスを作成できます。このプロキシは、設定されたすべてのサーバーに接続し、必要に応じて適切なツールを選択してタスクを実行します。

複数のサーバーの設定

プロジェクト内の設定ファイルで複数の MCP サーバーを定義できます。

{
  "mcpConfig": {
    "servers": [
      {
        "name": "playwright",
        "command": "npx",
        "args": ["@playwright/mcp", "--version"],
        "options": {
          "cwd": ".",
          "stdio": "inherit"
        }
      },
      {
        "name": "airbnb",
        "command": "npx",
        "args": ["-y", "@openfb/mcp-server-airbnb"]
      }
    ]
  }
}

プロキシの作成

TypeScript ファイル内で以下のコードを使用してプロキシを作成できます。

import { createMCPClient, createMCPAgent } from 'mcp-use-typscript';

async function main() {
  const client = await createMCPClient();
  const agent = createMCPAgent({
    client,
    llm: new LLM(),
    verbose: true
  });

  const result = await agent.run('你的任务指令');
  console.log(result);
}

main().catch(console.error);

🤝 コントリビューションガイド

このプロジェクトにコードやドキュメントを貢献したい場合は、CONTRIBUTING.md ファイルを参照して、参加方法とコードの提出方法を確認してください。