@mofanh/agent-core


@mofanh/agent-core 是一个现代化的智能代理框架，提供统一的 LLM 接口、完整的 MCP (Model Context Protocol) 支持和强大的工作流编排能力。

✨ 特性

- 🤖 统一 LLM 接口: 支持多种 LLM 提供商（OpenAI、Anthropic 等）
- � 完整 MCP 支持: 真正的外部服务调用能力，支持 stdio/HTTP 传输
- �📝 强大的 Prompt 系统: 模板化、变量注入、条件逻辑
- 🔄 工作流编排: 支持复杂的多步骤任务流和混合 LLM+MCP 任务
- 🌊 流式处理: 原生支持流式响应处理
- 🔧 可扩展架构: 插件化设计，易于扩展
- 📊 完整监控: 内置日志、健康检查和性能指标
- 🎯 类型安全: 完整的 JSDoc 类型支持
- ⚖️ 负载均衡: 多种连接池和负载均衡策略
- 🛡️ 容错机制: 自动重连、故障转移和错误恢复

📦 安装

``bash
npm install @mofanh/agent-core


或

yarn add @mofanh/agent-core

或

pnpm add @mofanh/agent-core
`

🚀 快速开始

$3

`javascript
import { AgentCore } from 'agent-core';

const agent = new AgentCore({
llmProvider: {
type: 'openai',
apiKey: process.env.OPENAI_API_KEY,
model: 'gpt-4'
}
});

await agent.initialize();
const result = await agent.execute({
task: 'chat',
messages: [
{ role: 'user', content: '你好，介绍一下你自己' }
]
});
`

$3

`javascript
import { createMCPAgent, createSmartAgent } from 'agent-core';

// 创建 MCP 代理
const mcpAgent = await createMCPAgent({
servers: [
{ name: 'web', transport: 'stdio', command: 'web-mcp-server' },
{ name: 'file', transport: 'http', url: 'http://localhost:3000' }
]
});

// 调用外部工具
const result = await mcpAgent.callTool('fetch_page', {
url: 'https://example.com'
});

// 创建智能代理（LLM + MCP）
const smartAgent = await createSmartAgent({
llm: {
provider: 'openai',
options: { model: 'gpt-4', apiKey: process.env.OPENAI_API_KEY }
},
mcp: {
servers: [
{ name: 'web', transport: 'stdio', command: 'web-mcp-server' }
]
}
});

// 执行混合任务
const analysis = await smartAgent.execute({
type: 'hybrid',
initialPrompt: {
messages: [{ role: 'user', content: '分析网站 https://example.com 的内容' }]
},
workflow: [
{
type: 'mcp_tool',
name: 'fetchPage',
toolName: 'fetch_page',
args: { url: 'https://example.com' }
},
{
type: 'llm',
name: 'analyze',
prompt: (data) => ({
messages: [
{ role: 'system', content: '你是一个网页内容分析专家。' },
{ role: 'user', content: 请分析这个网页内容：${data.fetchPage?.content} }
]
})
}
]
});
`
});
`

$3

`typescript
import { analyzePage } from 'agent-core';

const analysis = await analyzePage('https://example.com', {
includeImages: true,
extractText: true,
analyzeStructure: true
});

console.log(analysis.pageInfo);
console.log(analysis.domStructure);
`

$3

`typescript
import { manipulateDOM } from 'agent-core';

const result = await manipulateDOM('https://example.com', {
actions: [
{ type: 'click', selector: '#submit-button' },
{ type: 'fill', selector: '#email', value: 'user@example.com' },
{ type: 'wait', duration: 1000 }
]
});
`

$3

`typescript
import { batchProcess } from 'agent-core';

const tasks = [
{ task: 'analyze_page', target: 'https://example1.com' },
{ task: 'analyze_page', target: 'https://example2.com' },
{ task: 'fill_form', target: 'https://example3.com', data: { email: 'test@example.com' } }
];

const results = await batchProcess(tasks, {
concurrency: 3,
failFast: false
});
`

配置选项

$3

- performance: 性能优化配置，适合大量操作
- debug: 调试配置，包含详细日志

`typescript
import { createAgent, PRESET_CONFIGS } from 'agent-core';

// 使用预设配置
const agent = createAgent('performance', {
llmProvider: {
apiKey: process.env.OPENAI_API_KEY
}
});

// 查看预设配置
console.log(PRESET_CONFIGS.basic);
`

$3

`typescript
const customConfig = {
llmProvider: {
type: 'openai',
apiKey: process.env.OPENAI_API_KEY,
model: 'gpt-4',
temperature: 0.7,
maxTokens: 2000
},
mcpServers: ['dom', 'page', 'forms'],
performance: {
timeout: 30000,
maxRetries: 3,
cacheEnabled: true
},
validation: {
strict: true,
validateInputs: true,
validateOutputs: true
},
logging: {
level: 'info',
enablePerformanceLogging: true,
enableErrorTracking: true
}
};

const agent = new AgentCore(customConfig);
`

API 参考

$3

主要的代理类，提供完整的功能。

#### 方法

- initialize(): 初始化代理
- execute(task): 执行单个任务
- executeBatch(tasks, options?): 批量执行任务
- executeStream(task): 流式执行任务
- getHealth(): 获取代理健康状态
- getCapabilities(): 获取代理能力信息
- shutdown(): 关闭代理

#### 配置接口

详细的配置选项请参考 TypeScript 类型定义。

开发

$3

`bash


克隆项目

git clone
cd agent-core

安装依赖

npm install

开发模式

npm run dev

构建

npm run build

测试

npm run test

代码检查

npm run lint
`

$3

项目使用 Rollup 进行构建，支持 ES 模块和 CommonJS 格式：

`bash
npm run build
`

构建产物：
- lib/m.js - ES 模块格式
- lib/cjs.js - CommonJS 格式
- lib/umd.js - UMD 格式
- lib/amd.js` - AMD 格式

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！