MCP 통합
Model Context Protocol을 사용하여 에이전트를 외부 도구와 연결합니다. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
Model Context Protocol을 사용하여 에이전트를 외부 도구와 연결합니다.
빠른 시작
전체 예제 클론하기
가장 쉬운 시작 방법은 전체 예제 저장소를 클론하는 것입니다:
git clone https://github.com/astreus-ai/examples
cd examples/mcp-integration
npm install또는 패키지만 설치하기
처음부터 직접 구축하려면:
npm install @astreus-ai/astreus환경 설정
# .env
OPENAI_API_KEY=sk-your-openai-api-key-here
DB_URL=sqlite://./astreus.dbMCP 서버 통합
import { config } from 'dotenv';
import { Agent, Graph } from '@astreus-ai/astreus';
config();
async function main() {
const mainAgent = await Agent.create({
name: 'FileAnalysisAgent',
model: 'gpt-4o',
systemPrompt: 'You are a file analysis agent that processes files using graph-based workflows and MCP tools.'
});
const mcpConfig = {
name: 'filesystem',
command: "npx",
args: ["@modelcontextprotocol/server-filesystem", process.cwd()]
};
await mainAgent.addMCPServers([mcpConfig]);
await new Promise(resolve => setTimeout(resolve, 3000));
const analysisGraph = new Graph({
name: 'File Summary Workflow',
maxConcurrency: 1
}, mainAgent);
const readTask = analysisGraph.addTaskNode({
name: 'File Reading',
prompt: 'Read the content of "./info.txt" file and analyze it.',
priority: 1
});
const summaryTask = analysisGraph.addTaskNode({
name: 'Summary Creation',
prompt: 'Based on the analyzed file content from the previous task, create a concise summary and save it as "./summary.txt" file.',
dependencies: [readTask],
priority: 2
});
const result = await analysisGraph.run({
stream: true,
onChunk: (chunk) => {
console.log(chunk);
}
});
}
main().catch(console.error);예제 실행하기
저장소를 클론했다면:
npm run dev처음부터 구축했다면, 위 코드로 index.ts 파일을 만들고 다음을 실행하세요:
npx tsx index.ts저장소
전체 예제는 GitHub에서 확인할 수 있습니다: examples/mcp-integration
마지막 업데이트: 2026년 7월 6일
이 섹션에서
첫 번째 에이전트
Astreus 문서에서 첫 번째 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
메모리를 갖춘 에이전트
Astreus 문서에서 메모리를 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
지식 기반을 갖춘 에이전트
Astreus 문서에서 지식 기반을 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.
비전을 갖춘 에이전트
Astreus 문서에서 비전을 갖춘 에이전트에 대해 알아보고, 에이전트 시스템을 구축하기 위한 설정 안내, API 패턴, 실용적인 예제를 확인하세요. 안정적인 Astreus 에이전트 시스템을 구축하는 데 필요한 설정 패턴, API, 실용적인 예제를 알아보세요.