Easy MCP Use

🚀 MCP-Use-TS

MCP-Use-TS 是一个专为 TypeScript 打造的 MCP 库。它能让你轻松配置并连接多个 MCP 服务器，还能在项目中便捷使用这些服务器。该库旨在简化与不同 MCP 实现（如 Playwright MCP）的集成，让你能更专注于业务逻辑的实现。

如果你有任何问题或建议，欢迎随时提出 issue 或 pull request。

🚀 快速开始

项目配置

在你的 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 服务。

📦 安装指南

npm install mcp-use-typscript

📚 详细文档

配置文件格式

你的配置文件应包含以下内容：

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 文件，了解如何参与和提交代码。