joshuaalpuerto/mcp-agent

View on GitHub ↗

Lightweight, focused utilities to manage connections and execute MCP tools with minimal integration effort. Use it to directly call tools or build simple agents within your current architecture.

18 ★4 forksTypeScriptUpdated 6mo ago

What you need to know

TypeScript framework (inspired by lastmile-ai/mcp-agent) for building type-safe AI agents that leverage MCP servers, local function tools, and LLM integration.

Install

npm install @joshuacalpuerto/mcp-agent
Set up .env with API keys
pnpm install for the demo

Usage

  • •Define agents with MCP server configs
  • •Compose researcher/writer orchestration
  • •Run the demo

Key features

  • ✓Agent abstraction with instructions and tools
  • ✓MCP integration (stdio, sse, streamable-http, websockets)
  • ✓Local function tools alongside MCP tools
  • ✓LLM flexibility with example Fireworks implementation
  • ✓Orchestrator workflow pattern
  • ✓In-memory message history

Caveats

  • ⚠Requires LLM API keys (e.g., Fireworks AI)
Platforms: Local

Reviewed 2026-08-11

Topics

agentsai-agentsllmmcpmcp-agentmodel-context-protocolnodejstypescript
Stars
18★
Forks
4
Language
TypeScript
License
—
Created
2025-03-25
Last push
2026-02-28