{
  "mcpServers": {
    "workflows-mcp": {
      "command": "npx",
      "args": ["-y", "mcpn@latest server"]
    }
  }
}

{
  "mcpServers": {
    "workflows-mcp": {
      "command": "npx",
      "args": [
        "mcpn@latest server",
        "--config",
        "/path/to/.workflows",
        "--preset",
        "thinking,coding"
      ]
    }
  }
}

安装与配置

入门指南

安装

使用以下命令安装最新版本：

npm install mcp --save

或者指定版本：

npm install mcp@latest --save

通过 package.json 引入 MCP：

{
  "dependencies": {
    "mcp": "^2.0.0"
  }
}

初始化

初始化 MCP 实例：

const mcp = new MCP({
  // 配置选项
});

命令行工具

安装后使用以下命令获取帮助信息：

npx mcp --help

常用命令选项：

选项	描述
--version	显示 MCP 版本号
--config	设置配置文件路径

配置参考

MCP 支持以下配置选项：

核心配置

{
  port: number,
  host: string,
  logLevel: 'debug' | 'info' | 'warn' | 'error',
  enableCache: boolean,
  cacheProvider: CacheProviderType,
  plugins: Plugin[]
}

插件扩展

插件配置示例：

{
  plugins: [
    {
      name: 'customPlugin',
      path: './plugins/customPlugin.js',
      config: {
        enabled: true,
        options: {}
      }
    }
  ]
}

高级主题

缓存机制

MCP 支持多种缓存策略：

• 内存缓存：默认使用 MemoryCache 实现。
• 文件缓存：通过插件扩展支持。
• 数据库缓存：集成第三方数据库实现。

错误处理

自定义错误处理器：

mcp.setErrorHandler((error) => {
  console.error('Error:', error.message);
});

示例代码

const mcp = new MCP({
  port: 3000,
  host: 'localhost',
  plugins: [
    {
      name: 'analyticsPlugin',
      enabled: true
    }
  ]
});

mcp.start().then(() => {
  console.log('MCP 已启动');
});

工具使用说明

基本用法

创建工具实例

const tool = mcp.createTool({
  name: 'myTool',
  config: {}
});

执行任务

tool.execute(task => {
  // 处理逻辑
}).then(result => {
  console.log('执行完成:', result);
});

高级用法

工具链式操作

mcp.chain([
  tool1,
  tool2,
  ...
]).execute();

并行处理

配置工具以并行方式执行：

tool.setConcurrency(5);

配置参考

核心选项

选项	类型	描述
port	number	服务端口
host	string	主机地址
logLevel	string	日志级别

插件扩展

插件接口定义：

interface Plugin {
  name: string;
  config?: any;
  enabled?: boolean;
}

示例代码

const mcp = new MCP({
  port: 3000,
  host: 'localhost',
  plugins: [
    {
      name: 'analyticsPlugin',
      enabled: true
    }
  ]
});

mcp.start().then(() => {
  console.log('MCP 已启动');
});

错误处理

自定义错误处理器

mcp.setErrorHandler((error) => {
  console.error('Error:', error.message);
});

常见问题

服务启动失败

检查端口是否被占用或配置错误。

插件加载失败

确保插件路径正确且文件存在。

工具扩展

创建自定义工具

实现 ITool 接口：

interface ITool {
  execute(task: any): Promise<void>;
}

注册工具：

mcp.registerTool('myTool', new MyCustomTool());

工具链式操作

配置工具以链式方式执行任务：

const chain = mcp.chain([
  tool1,
  tool2
]);
chain.execute(tasks);

日志管理

配置日志输出

设置日志级别：

mcp.setLogLevel('debug');

自定义日志格式：

mcp.setLogger({
  log: (...args) => console.log(...args),
  error: (...args) => console.error(...args)
});

监控与跟踪

集成第三方监控工具：

mcp.addMonitor(monitorPlugin);

性能调优

配置优化

调整缓存策略：

mcp.setCacheProvider(new RedisCache());

设置并发限制：

tool.setConcurrency(10);

分析与报告

生成性能报告：

mcp.generateReport();

常见问题解答

服务启动失败

• 检查配置文件是否正确。
• 确保端口未被占用。

插件加载失败

• 确认插件路径和名称正确。
• 检查插件是否存在且格式正确。

性能问题

• 调整缓存策略。
• 优化并发处理逻辑。

示例代码

初始化 MCP 实例

const mcp = new MCP({
  port: 3000,
  host: 'localhost',
  plugins: [
    {
      name: 'analyticsPlugin'
    }
  ]
});

mcp.start().then(() => {
  console.log('MCP 已启动');
});

创建并注册工具

const tool = mcp.createTool({
  name: 'myTool',
  config: {}
});

mcp.registerTool('myTool', tool);

执行任务

tool.execute(task => {
  // 处理逻辑
}).then(result => {
  console.log('完成:', result);
});

附录

API 文档

类与接口

• MCP：主类，用于管理工具和服务。
• Tool：工具基类，提供基础功能。

方法列表

• start()：启动服务。
• stop()：停止服务。
• createTool()：创建新工具实例。
• registerPlugin()：注册插件。

代码示例

const mcp = new MCP({
  port: 3000,
  host: 'localhost'
});

mcp.createTool('myTool').execute();

最后

感谢使用 MCP，如需帮助，请参考文档或联系支持团队。