Getting Started
- agent-framework
About
What is Getting Started?
Getting Started is a local development client application built with a LangGraph agent that connects to MCP servers and calls their tools, paired with a CopilotKit frontend for UI and state synchronization. It runs on a developer’s machine using pnpm and Node.js, and is intended for developers building AI assistants that leverage MCP tools.
How to use Getting Started?
Set up environment variables by creating a .env file at the project root (with LANGSMITH_API_KEY) and another .env file inside the agent folder (with OPENAI_API_KEY and LANGSMITH_API_KEY). For development, run the frontend and agent separately in two terminals using pnpm run dev-frontend and `pnpm run
Details
- Author
- mdhelaluddinbiswas
- GitHub stars
- 2
- Category
- agent-framework
- Repository
- mdhelaluddinbiswas/open-mcp-client
https://github.com/user-attachments/assets/f72e1f7d-3c84-4429-a465-23dff3d3bd63
Getting Started
Set Up Environment Variables:
touch .env
Add the following inside .env at the root:
LANGSMITH_API_KEY=lsv2_...
Next, create another .env file inside the agent folder:
cd agent
touch .env
Add the following inside agent/.env:
OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...
Development
We recommend running the frontend and agent separately in different terminals to debug errors and logs:
# Terminal 1 - Frontend
pnpm run dev-frontend
Terminal 2 - Agent
pnpm run dev-agent
Alternatively, you can run both services together with:
pnpm run dev
Then, open http://localhost:3000 in your browser.
Architecture
The codebase is split into two main parts:
1. /agent folder – A LangGraph agent that connects to MCP servers and calls their tools.
2. /app folder – A frontend application using CopilotKit for UI and state synchronization.
