mcp-client-helper

mcp-client-helper

MCP 客户端助手（管理、执行 MCP 服务器）

Yangbin-v

开发者工具
访问服务器

README

mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

功能特性

  • 通过配置管理多个MCP服务器
  • 支持启动、停止和重启服务器
  • 实时监控所有服务器状态
  • 事件驱动的日志和错误处理
  • 支持自定义环境变量配置

安装

npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC


# mcp-client-helper

MCP 服务器管理工具库 - 用于通过配置文件管理和控制多个 MCP 服务器实例

## 功能特性

- 通过配置管理多个 MCP 服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API 文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP 服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程 ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC


# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC

# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC

# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC

# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC


# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;  // 服务器配置映射
}

interface ServerStatus {
  isRunning: boolean;   // 是否正在运行
  pid?: number;         // 进程ID
  startTime?: Date;     // 启动时间
  name: string;         // 服务器名称
  command: string;      // 启动命令
}

开发要求

  • Node.js >= 14.0.0
  • TypeScript >= 4.0.0

许可证

ISC


# mcp-client-helper

MCP服务器管理工具库 - 用于通过配置文件管理和控制多个MCP服务器实例

## 功能特性

- 通过配置管理多个MCP服务器
- 支持启动、停止和重启服务器
- 实时监控所有服务器状态
- 事件驱动的日志和错误处理
- 支持自定义环境变量配置

## 安装

```bash
npm install mcp-client-helper

配置格式

配置对象格式示例：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

使用示例

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[${serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[${serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

API文档

MCPServerManager

构造函数

constructor(config: MCPConfig)

配置参数：

  • config: MCP服务器配置对象，包含所有要管理的服务器配置

方法

  • start(serverName: string): Promise<void>: 启动指定的服务器
  • stop(serverName: string): Promise<void>: 停止指定的服务器
  • restart(serverName: string): Promise<void>: 重启指定的服务器
  • getStatus(serverName: string): ServerStatus | undefined: 获取指定服务器的状态
  • getAllStatuses(): Record<string, ServerStatus>: 获取所有服务器的状态
  • getServerNames(): string[]: 获取所有配置的服务器名称
  • updateConfig(config: MCPConfig): void: 动态更新服务器配置

事件

  • log: (serverName: string, log: string) => void - 服务器日志输出
  • error: (serverName: string, error: string) => void - 服务器错误输出
  • exit: (serverName: string, code: number | null) => void - 服务器退出事件

配置类型定义

interface MCPServerConfig {
  command: string;      // 服务器启动命令
  args: string[];       // 命令行参数
  env?: Record<string, string>;  // 环境变量
}

interface MCPConfig {
  mcpServers: Record<string, MCPServerConfig>;

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript