Skip to content

Commit 83a54ab

Browse files
committed
docs(mcps and supabase): add assets and readmes
1 parent 6f074d1 commit 83a54ab

File tree

5 files changed

+129
-2
lines changed

5 files changed

+129
-2
lines changed

README.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@
1010
- [VSCode Devcontainer](#vscode-devcontainer)
1111
- [Without VSCode Devcontainer](#without-vscode-devcontainer)
1212
- [Refactored Markdown Files](#refactored-markdown-files)
13+
- [MCP](#mcp)
14+
- [Supabase](#supabase)
15+
- [Debugging](#debugging)
1316
<!--toc:end-->
1417

1518
## Core Features
@@ -90,6 +93,8 @@ docker compose up -d
9093

9194
## Development
9295

96+
First, set environment variables as per above.
97+
9398
### VSCode Devcontainer
9499

95100
> [!WARNING]
@@ -125,5 +130,18 @@ docker compose -f compose-dev.yaml up -d
125130

126131
The following markdown files provide additional details on other features:
127132

128-
- [`./docs/mcp.md`](./docs/mcp.md)
129-
- [`./docs/supabase.md`](./docs/supabase.md)
133+
### MCP
134+
135+
[`./docs/mcp.md`](./docs/mcp.md)
136+
137+
### Supabase
138+
139+
[`./docs/supabase.md`](./docs/supabase.md)
140+
141+
## Debugging
142+
143+
Sometimes in development, nginx reverse proxy needs to reload its config to route services properly.
144+
145+
```bash
146+
docker compose -f compose-dev.yaml exec nginx sh -c "nginx -s reload"
147+
```

docs/assets/mcps.mp4

2.98 MB
Binary file not shown.

docs/assets/supabase.mp4

4.28 MB
Binary file not shown.

docs/mcp.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# MCPs
2+
3+
<!--toc:start-->
4+
- [MCPs](#mcps)
5+
- [Video Demo](#video-demo)
6+
- [Key Features](#key-features)
7+
- [Inspector](#inspector)
8+
- [Community MCPs](#community-mcps)
9+
- [DBHub](#dbhub)
10+
- [Youtube](#youtube)
11+
- [Custom MCP](#custom-mcp)
12+
<!--toc:end-->
13+
14+
[![MCP Client](https://img.shields.io/github/stars/modelcontextprotocol/python-sdk?logo=modelcontextprotocol&label=MCP-Client)](https://github.com/modelcontextprotocol/python-sdk) [![MCP Server](https://img.shields.io/github/stars/modelcontextprotocol/servers?logo=modelcontextprotocol&label=MCP-Servers)](https://github.com/modelcontextprotocol/servers)
15+
16+
> MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.
17+
18+
Learn more [here](https://modelcontextprotocol.io/introduction).
19+
20+
## Video Demo
21+
22+
![mcps](./assets/mcps.mp4)
23+
24+
## Key Features
25+
26+
> MCP helps you build agents and complex workflows on top of LLMs. LLMs frequently need to integrate with data and tools, and MCP provides:
27+
> - A growing list of pre-built integrations that your LLM can directly plug into
28+
> - The flexibility to switch between LLM providers and vendors
29+
> - Best practices for securing your data within your infrastructure
30+
31+
## Inspector
32+
33+
Explore community and your custom MCP servers via Inspector at [http://localhost:6274](http://localhost:6274) in [Development](../README.md#development).
34+
35+
Left Sidebar:
36+
37+
- Select SSE `Transport Type`
38+
- Input `http://<mcp server>:<MCP_SERVER_PORT>/sse` in `URL`
39+
- Click `Connect`
40+
41+
Explore the following tabs in the Top Navbar:
42+
43+
- `Resources`
44+
- `Prompts`
45+
- `Tools`.
46+
47+
## Community MCPs
48+
49+
Before building your own custom MCP, explore the growing list of hundreds of [community MCPs](https://github.com/modelcontextprotocol/servers). With integrations spanning databases, cloud services, and web resources, the perfect fit might already exist.
50+
51+
### DBHub
52+
53+
Learn more [here](https://github.com/bytebase/dbhub). Explore more in [Inspector](#inspector).
54+
55+
Easily plug in this MCP into LLM to allow LLM to:
56+
57+
- Perform read-only SQL query validation for secure operations
58+
- Enable deterministic introspection of DB
59+
- List schemas
60+
- List tables in schemas
61+
- Retrieve table structures
62+
- Enrich user queries deterministically
63+
- Ground DB related queries with DB schemas
64+
- Provide SQL templates for translating natural language to SQL
65+
66+
### Youtube
67+
68+
Learn more [here](https://github.com/Klavis-AI/klavis/tree/main/mcp_servers/youtube). Explore more in [Inspector](#inspector).
69+
70+
Instead of building logic to:
71+
72+
- Scrape YouTube content
73+
- Adapt outputs for LLM compatibility
74+
- Validate tool invocation by the LLM
75+
- Chain these steps to fetch transcripts from URLs
76+
77+
Simply plug in this MCP to enable LLM to:
78+
79+
- Fetch transcripts from any YouTube URL on demand
80+
81+
## Custom MCP
82+
83+
Should you require a custom MCP, a template is provided [here](https://github.com/NicholasGoh/fastapi-mcp-langgraph-template/blob/main/backend/shared_mcp/tools.py) for you to reference in development.

docs/supabase.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Supabase
2+
3+
[![Supabase](https://img.shields.io/github/stars/supabase/supabase?logo=supabase&label=Supabase)](https://github.com/supabase/supabase)
4+
5+
<!--toc:start-->
6+
- [Supabase](#supabase)
7+
- [Video Demo](#video-demo)
8+
- [Features](#features)
9+
<!--toc:end-->
10+
11+
## Video Demo
12+
13+
![Supabase](./assets/supabase.mp4)
14+
15+
## Features
16+
17+
Visit [here](https://supabase.com/) for a full list of features and learn more.
18+
19+
- Postgres Relational Database
20+
- Authentication
21+
- User Sign up and Login
22+
- Row and Column Security
23+
- Data APIs
24+
- Auto Generated from Table Schema
25+
- Self Host for free
26+
- Free Cloud usage for rapid prototyping

0 commit comments

Comments
 (0)