https://github.com/copilotkit/open-mcp-client
https://github.com/copilotkit/open-mcp-client
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/copilotkit/open-mcp-client
- Owner: CopilotKit
- Created: 2025-03-08T19:22:42.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T14:29:58.000Z (9 months ago)
- Last Synced: 2025-04-08T15:00:34.477Z (9 months ago)
- Language: TypeScript
- Homepage: https://open-mcp-client.vercel.app/
- Size: 165 KB
- Stars: 1,084
- Watchers: 5
- Forks: 168
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
https://github.com/user-attachments/assets/364b6705-14d4-4e6d-bea7-fb9f12664fab
# Getting Started
## Set Up Environment Variables:
```sh
touch .env
```
Add the following inside `.env` at the root:
```sh
LANGSMITH_API_KEY=lsv2_...
OPENAI_API_KEY=sk-...
```
Next, create another `.env` file inside the `agent` folder:
```sh
cd agent
touch .env
```
Add the following inside `agent/.env`:
```sh
OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...
```
## Set Up Poetry:
Poetry is used for dependency management in the agent service. To install Poetry, run:
```sh
pip install poetry
```
To verify the installation, run:
```sh
poetry --version
```
## Development
We recommend running the **frontend and agent separately** in different terminals to debug errors and logs:
```bash
# Terminal 1 - Frontend
pnpm run dev-frontend
# Terminal 2 - Agent
pnpm run dev-agent
```
Alternatively, you can run both services together with:
```bash
pnpm run dev
```
Then, open [http://localhost:3000](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.