MCP 代理 TypeScript 端口
概述
MCP（模型上下文协议）代理 TypeScript 端口是 MCP 代理系统的一个健壮且类型安全的实现。它提供了一个灵活的框架，用于构建具有高级工作流管理、日志记录和执行功能的智能上下文感知代理。
这是lastmile-ai 原始 MCP Agent 框架的 TypeScript 端口。
特征
- 🚀模块化架构
- 全面的 TypeScript 实现
- 灵活、可扩展的设计
- 类型安全接口
- 📊高级工作流管理
- 基于步骤的工作流程执行
- 并发任务处理
- 详细的上下文跟踪
- 🔍强大的日志系统
- 🧰灵活的执行器
- 🖥️ CLI 支持
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 MCP Agent TypeScript 端口：
npx -y @smithery/cli install @waldzellai/mcp-agent-ts --client claude
手动安装
npm install @waldzell/mcp-agent-ts
快速入门
创建工作流
import { BaseWorkflow } from '@waldzell/mcp-agent-ts';
class MyDataProcessingWorkflow extends BaseWorkflow {
constructor() {
super('my-workflow', 'Data Processing');
this.addStep({
id: 'extract',
name: 'Data Extraction',
execute: async (context) => {
// Implement data extraction logic
return { data: ['item1', 'item2'] };
}
});
this.addStep({
id: 'transform',
name: 'Data Transformation',
execute: async (context) => {
// Implement data transformation logic
return { transformedData: ['ITEM1', 'ITEM2'] };
}
});
}
}
async function runWorkflow() {
const workflow = new MyDataProcessingWorkflow();
const results = await workflow.execute();
console.log(results);
}
日志记录
import { debug, info, warn, error } from '@waldzell/mcp-agent-ts';
// Log with different levels
debug('Debugging information', { userId: 123 });
info('System started');
warn('Potential issue detected');
error('Critical error occurred');
CLI 使用
# Start the MCP Agent
npx mcp-agent start
# List available tools
npx mcp-agent list-tools
# Set log level
npx mcp-agent log-level debug
执行器使用
import { BaseExecutor, Task } from '@waldzell/mcp-agent-ts';
const executor = new BaseExecutor({
maxConcurrentTasks: 3,
timeout: 60000 // 1-minute timeout
});
const task: Task = {
id: 'example-task',
name: 'Sample Task',
execute: async () => {
// Task implementation
return 'Task completed';
}
};
await executor.enqueueTask(task);
配置
MCP 代理可以通过以下方式配置：
开发现状
🚧早期开发🚧
此移植版本处于早期阶段，功能尚未完善。欢迎贡献和反馈！
原始项目
原始 MCP 代理： lastmile-ai/mcp-agent
贡献
- 分叉存储库
- 创建你的功能分支（
git checkout -b feature/AmazingFeature ） - 提交您的更改（
git commit -m 'Add some AmazingFeature' ） - 推送到分支（
git push origin feature/AmazingFeature ） - 打开拉取请求
执照
该项目遵循原始 MCP Agent 项目的许可证，可在此处找到。
致谢
特别感谢最初的 MCP Agent 开发人员为 AI 代理开发创建了一个创新框架。