MCP 에이전트 TypeScript 포트
개요
MCP(Model Context Protocol) Agent TypeScript Port는 MCP Agent 시스템의 강력하고 타입 안전한 구현체입니다. 고급 워크플로 관리, 로깅 및 실행 기능을 갖춘 지능형 컨텍스트 인식 에이전트를 구축하기 위한 유연한 프레임워크를 제공합니다.
이는 lastmile-ai가 만든 원래 MCP Agent 프레임워크 의 TypeScript 포트입니다.
특징
- 🚀 모듈형 아키텍처
- 포괄적인 TypeScript 구현
- 유연하고 확장 가능한 디자인
- 유형 안전 인터페이스
- 📊 고급 워크플로 관리
- 단계 기반 워크플로 실행
- 동시 작업 처리
- 자세한 컨텍스트 추적
- 🔍 강력한 로깅 시스템
- 구성 가능한 로그 수준
- 컨텍스트가 풍부한 로깅
- 로그 내보내기 기능
- 🧰 유연한 실행자
- 🖥️ CLI 지원
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 MCP Agent TypeScript Port를 자동으로 설치하려면:
지엑스피1
수동 설치
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 프로젝트의 라이센스를 따릅니다.
감사의 말
AI 에이전트 개발을 위한 혁신적인 프레임워크를 만들어 준 원래 MCP 에이전트 개발자에게 특별히 감사드립니다.