MCPcopy Index your code
hub / github.com/CopilotKit/open-mcp-client

github.com/CopilotKit/open-mcp-client @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
40 symbols 102 edges 21 files 4 documented · 10%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Open MCP Client

CopilotKit-Banner

https://github.com/user-attachments/assets/364b6705-14d4-4e6d-bea7-fb9f12664fab

Getting Started

Set Up Environment Variables

Create a .env file at the root of your project:

touch .env

Add the following to .env:

LANGSMITH_API_KEY=lsv2_...
OPENAI_API_KEY=sk-...

Next, navigate to the agent folder and create another .env file:

cd agent
touch .env

Add the following inside agent/.env:

OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...

Set Up Poetry:

Poetry manages dependencies for the agent service. Install it with:

pip install poetry

Verify the installation by running:

poetry --version

Development

For easier debugging, run the frontend and agent in separate terminals:

# Terminal 1 - Frontend
pnpm run dev-frontend

# Terminal 2 - Agent
pnpm run dev-agent

Alternatively, launch both services together:

pnpm run dev

Visit http://localhost:3000 in your browser to view the application.

Architecture

The codebase is organized into two primary components:

  • Frontend - Handles the user interface.
  • Agent - Manages the core functionality.

License

Distributed under the MIT License. See LICENSE for more info.

Extension points exported contracts — how you extend this code

Cell (Interface)
(no doc)
app/types.ts
MainAreaProps (Interface)
(no doc)
app/components/SingleSpreadsheet.tsx
RowLike (Interface)
(no doc)
app/utils/canonicalSpreadsheetData.ts
SpreadsheetData (Interface)
(no doc)
app/types.ts
StdioConfig (Interface)
(no doc)
app/components/MCPConfigForm.tsx
CellLike (Interface)
(no doc)
app/utils/canonicalSpreadsheetData.ts
SSEConfig (Interface)
(no doc)
app/components/MCPConfigForm.tsx
AgentState (Interface)
(no doc)
app/components/MCPConfigForm.tsx

Core symbols most depended-on inside this repo

setConfigs
called by 5
app/components/MCPConfigForm.tsx
canonicalSpreadsheetData
called by 3
app/utils/canonicalSpreadsheetData.ts
formatJSON
called by 2
app/components/ToolCallRenderer.tsx
removeConfig
called by 1
app/components/MCPConfigForm.tsx
commitChangesButton
called by 1
app/components/PreviewSpreadsheetChanges.tsx
changesCommittedButtonPlaceholder
called by 1
app/components/PreviewSpreadsheetChanges.tsx
useLocalStorage
called by 1
app/hooks/useLocalStorage.ts
cn
called by 0
lib/utils.ts

Shape

Function 27
Interface 10
Class 3

Languages

TypeScript85%
Python15%

Modules by API surface

app/components/MCPConfigForm.tsx9 symbols
app/components/PreviewSpreadsheetChanges.tsx4 symbols
agent/sample_agent/agent.py4 symbols
app/utils/canonicalSpreadsheetData.ts3 symbols
app/hooks/useLocalStorage.ts3 symbols
app/components/ToolCallRenderer.tsx3 symbols
app/types.ts2 symbols
app/components/SingleSpreadsheet.tsx2 symbols
app/components/ExampleConfigs.tsx2 symbols
agent/math_server.py2 symbols
lib/utils.ts1 symbols
app/page.tsx1 symbols

For agents

$ claude mcp add open-mcp-client \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact