Commit
Β·
c1a84e8
1
Parent(s):
4a16168
Update URLs to MCP-1st-Birthday hackathon organization
Browse filesAll MCP endpoints and documentation now point to the official hackathon space:
- Space: MCP-1st-Birthday/TraceMind-mcp-server
- SSE Endpoint: mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse
- HTTP Endpoint: mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/
Removed development/production URL split - now ready for hackathon submission
README.md
CHANGED
|
@@ -55,15 +55,10 @@ All analysis is powered by **Google Gemini 2.5 Pro** for intelligent, context-aw
|
|
| 55 |
|
| 56 |
## π Quick Links
|
| 57 |
|
| 58 |
-
### Current Deployment (Development)
|
| 59 |
-
- **Gradio UI**: https://huggingface.co/spaces/kshitijthakkar/TraceMind-mcp-server
|
| 60 |
-
- **MCP Endpoint**: `https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/`
|
| 61 |
-
- **Auto-Config**: Add `kshitijthakkar-tracemind-mcp-server` at https://huggingface.co/settings/mcp
|
| 62 |
-
|
| 63 |
-
### After Hackathon Submission (Production)
|
| 64 |
- **Gradio UI**: https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server
|
| 65 |
-
- **MCP Endpoint**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp
|
| 66 |
-
- **
|
|
|
|
| 67 |
|
| 68 |
> π‘ **Tip**: Use the Auto-Config link above for the easiest setup! It generates the correct config for your MCP client automatically.
|
| 69 |
|
|
@@ -278,40 +273,24 @@ This Gradio app uses `mcp_server=True` in the launch configuration, which automa
|
|
| 278 |
|
| 279 |
Once deployed to HuggingFace Spaces, your MCP server will be available at:
|
| 280 |
|
| 281 |
-
|
| 282 |
-
**π― MCP Endpoint (Streamable HTTP - Recommended)**:
|
| 283 |
-
```
|
| 284 |
-
https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/
|
| 285 |
-
```
|
| 286 |
-
|
| 287 |
-
**β οΈ MCP Endpoint (SSE - Deprecated)**:
|
| 288 |
```
|
| 289 |
-
https://
|
| 290 |
```
|
| 291 |
|
| 292 |
-
|
| 293 |
-
**π― MCP Endpoint (Streamable HTTP - Recommended)**:
|
| 294 |
```
|
| 295 |
https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/
|
| 296 |
```
|
| 297 |
|
| 298 |
-
|
| 299 |
-
```
|
| 300 |
-
https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse
|
| 301 |
-
```
|
| 302 |
-
|
| 303 |
-
**Note**: Use the **Streamable HTTP endpoint** (recommended) for all new integrations. The SSE endpoint is deprecated and maintained for backward compatibility only. After submission to the hackathon org, use the `mcp-1st-birthday-tracemind-mcp-server` URLs.
|
| 304 |
-
|
| 305 |
-
Configure your MCP client (Claude Desktop, Cursor, Cline, etc.) with the streamable HTTP endpoint.
|
| 306 |
|
| 307 |
### β¨ Easiest Way to Connect
|
| 308 |
|
| 309 |
**Recommended for all users** - HuggingFace provides an automatic configuration generator:
|
| 310 |
|
| 311 |
1. **Visit**: https://huggingface.co/settings/mcp (while logged in)
|
| 312 |
-
2. **Add Space**: Enter
|
| 313 |
-
- **Development**: `kshitijthakkar-tracemind-mcp-server`
|
| 314 |
-
- **After Hackathon Submission**: `mcp-1st-birthday-tracemind-mcp-server`
|
| 315 |
3. **Select Client**: Choose Claude Desktop, VSCode, Cursor, etc.
|
| 316 |
4. **Copy Config**: Get the auto-generated configuration snippet
|
| 317 |
5. **Paste & Restart**: Add to your client's config file and restart
|
|
@@ -327,20 +306,8 @@ If you prefer to manually configure your MCP client:
|
|
| 327 |
{
|
| 328 |
"mcpServers": {
|
| 329 |
"tracemind": {
|
| 330 |
-
"url": "https://
|
| 331 |
-
"transport": "
|
| 332 |
-
}
|
| 333 |
-
}
|
| 334 |
-
}
|
| 335 |
-
```
|
| 336 |
-
|
| 337 |
-
**After Hackathon Submission - Use this URL instead**:
|
| 338 |
-
```json
|
| 339 |
-
{
|
| 340 |
-
"mcpServers": {
|
| 341 |
-
"tracemind": {
|
| 342 |
-
"url": "https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/",
|
| 343 |
-
"transport": "streamable-http"
|
| 344 |
}
|
| 345 |
}
|
| 346 |
}
|
|
@@ -348,18 +315,6 @@ If you prefer to manually configure your MCP client:
|
|
| 348 |
|
| 349 |
**VSCode / Cursor (`settings.json` or `.cursor/mcp.json`)**:
|
| 350 |
```json
|
| 351 |
-
{
|
| 352 |
-
"mcp.servers": {
|
| 353 |
-
"tracemind": {
|
| 354 |
-
"url": "https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/",
|
| 355 |
-
"transport": "streamable-http"
|
| 356 |
-
}
|
| 357 |
-
}
|
| 358 |
-
}
|
| 359 |
-
```
|
| 360 |
-
|
| 361 |
-
**After Hackathon Submission - Use this URL instead**:
|
| 362 |
-
```json
|
| 363 |
{
|
| 364 |
"mcp.servers": {
|
| 365 |
"tracemind": {
|
|
@@ -371,9 +326,8 @@ If you prefer to manually configure your MCP client:
|
|
| 371 |
```
|
| 372 |
|
| 373 |
**Cline / Other MCP Clients**:
|
| 374 |
-
- **
|
| 375 |
-
- **
|
| 376 |
-
- **Transport**: `streamable-http` (or `http` depending on client)
|
| 377 |
|
| 378 |
### β Connection FAQ
|
| 379 |
|
|
@@ -469,23 +423,14 @@ In Space settings β Tags, add:
|
|
| 469 |
|
| 470 |
Your MCP server will be publicly available at:
|
| 471 |
|
| 472 |
-
#### Current Space (Development)
|
| 473 |
-
|
| 474 |
**Gradio UI**:
|
| 475 |
```
|
| 476 |
-
https://huggingface.co/spaces/
|
| 477 |
-
```
|
| 478 |
-
|
| 479 |
-
**MCP Endpoint (Streamable HTTP)**:
|
| 480 |
-
```
|
| 481 |
-
https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/
|
| 482 |
```
|
| 483 |
|
| 484 |
-
|
| 485 |
-
|
| 486 |
-
**Gradio UI**:
|
| 487 |
```
|
| 488 |
-
https://
|
| 489 |
```
|
| 490 |
|
| 491 |
**MCP Endpoint (Streamable HTTP)**:
|
|
@@ -690,20 +635,18 @@ This MCP server builds upon our open source agent evaluation ecosystem:
|
|
| 690 |
- **Description**: Lightweight, production-ready evaluation framework for AI agents with OpenTelemetry instrumentation
|
| 691 |
- **GitHub**: [https://github.com/Mandark-droid/SMOLTRACE](https://github.com/Mandark-droid/SMOLTRACE)
|
| 692 |
- **PyPI**: [https://pypi.org/project/smoltrace/](https://pypi.org/project/smoltrace/)
|
| 693 |
-
- **Social**: [@smoltrace on X](https://twitter.com/smoltrace)
|
| 694 |
|
| 695 |
#### π TraceVerde - GenAI OpenTelemetry Instrumentation
|
| 696 |
- **Description**: Automatic OpenTelemetry instrumentation for LLM frameworks (LiteLLM, Transformers, LangChain, etc.)
|
| 697 |
- **GitHub**: [https://github.com/Mandark-droid/genai_otel_instrument](https://github.com/Mandark-droid/genai_otel_instrument)
|
| 698 |
- **PyPI**: [https://pypi.org/project/genai-otel-instrument](https://pypi.org/project/genai-otel-instrument)
|
| 699 |
-
- **Social**: [@genai_otel on X](https://twitter.com/genai_otel)
|
| 700 |
|
| 701 |
### Built By
|
| 702 |
|
| 703 |
**Track**: Building MCP (Enterprise)
|
| 704 |
**Author**: Kshitij Thakkar
|
| 705 |
-
**Powered by**: Google Gemini 2.5
|
| 706 |
-
**Built with**: Gradio
|
| 707 |
|
| 708 |
---
|
| 709 |
|
|
|
|
| 55 |
|
| 56 |
## π Quick Links
|
| 57 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 58 |
- **Gradio UI**: https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server
|
| 59 |
+
- **MCP Endpoint (SSE - Recommended)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse`
|
| 60 |
+
- **MCP Endpoint (Streamable HTTP)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/`
|
| 61 |
+
- **Auto-Config**: Add `MCP-1st-Birthday/TraceMind-mcp-server` at https://huggingface.co/settings/mcp
|
| 62 |
|
| 63 |
> π‘ **Tip**: Use the Auto-Config link above for the easiest setup! It generates the correct config for your MCP client automatically.
|
| 64 |
|
|
|
|
| 273 |
|
| 274 |
Once deployed to HuggingFace Spaces, your MCP server will be available at:
|
| 275 |
|
| 276 |
+
**π― MCP Endpoint (SSE - Recommended)**:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 277 |
```
|
| 278 |
+
https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse
|
| 279 |
```
|
| 280 |
|
| 281 |
+
**MCP Endpoint (Streamable HTTP)**:
|
|
|
|
| 282 |
```
|
| 283 |
https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/
|
| 284 |
```
|
| 285 |
|
| 286 |
+
**Note**: Both SSE and Streamable HTTP endpoints are fully supported. The SSE endpoint is recommended for most MCP clients.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 287 |
|
| 288 |
### β¨ Easiest Way to Connect
|
| 289 |
|
| 290 |
**Recommended for all users** - HuggingFace provides an automatic configuration generator:
|
| 291 |
|
| 292 |
1. **Visit**: https://huggingface.co/settings/mcp (while logged in)
|
| 293 |
+
2. **Add Space**: Enter `MCP-1st-Birthday/TraceMind-mcp-server`
|
|
|
|
|
|
|
| 294 |
3. **Select Client**: Choose Claude Desktop, VSCode, Cursor, etc.
|
| 295 |
4. **Copy Config**: Get the auto-generated configuration snippet
|
| 296 |
5. **Paste & Restart**: Add to your client's config file and restart
|
|
|
|
| 306 |
{
|
| 307 |
"mcpServers": {
|
| 308 |
"tracemind": {
|
| 309 |
+
"url": "https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse",
|
| 310 |
+
"transport": "sse"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 311 |
}
|
| 312 |
}
|
| 313 |
}
|
|
|
|
| 315 |
|
| 316 |
**VSCode / Cursor (`settings.json` or `.cursor/mcp.json`)**:
|
| 317 |
```json
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 318 |
{
|
| 319 |
"mcp.servers": {
|
| 320 |
"tracemind": {
|
|
|
|
| 326 |
```
|
| 327 |
|
| 328 |
**Cline / Other MCP Clients**:
|
| 329 |
+
- **URL**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse`
|
| 330 |
+
- **Transport**: `sse` (or use streamable HTTP endpoint with `streamable-http` transport)
|
|
|
|
| 331 |
|
| 332 |
### β Connection FAQ
|
| 333 |
|
|
|
|
| 423 |
|
| 424 |
Your MCP server will be publicly available at:
|
| 425 |
|
|
|
|
|
|
|
| 426 |
**Gradio UI**:
|
| 427 |
```
|
| 428 |
+
https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 429 |
```
|
| 430 |
|
| 431 |
+
**MCP Endpoint (SSE - Recommended)**:
|
|
|
|
|
|
|
| 432 |
```
|
| 433 |
+
https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse
|
| 434 |
```
|
| 435 |
|
| 436 |
**MCP Endpoint (Streamable HTTP)**:
|
|
|
|
| 635 |
- **Description**: Lightweight, production-ready evaluation framework for AI agents with OpenTelemetry instrumentation
|
| 636 |
- **GitHub**: [https://github.com/Mandark-droid/SMOLTRACE](https://github.com/Mandark-droid/SMOLTRACE)
|
| 637 |
- **PyPI**: [https://pypi.org/project/smoltrace/](https://pypi.org/project/smoltrace/)
|
|
|
|
| 638 |
|
| 639 |
#### π TraceVerde - GenAI OpenTelemetry Instrumentation
|
| 640 |
- **Description**: Automatic OpenTelemetry instrumentation for LLM frameworks (LiteLLM, Transformers, LangChain, etc.)
|
| 641 |
- **GitHub**: [https://github.com/Mandark-droid/genai_otel_instrument](https://github.com/Mandark-droid/genai_otel_instrument)
|
| 642 |
- **PyPI**: [https://pypi.org/project/genai-otel-instrument](https://pypi.org/project/genai-otel-instrument)
|
|
|
|
| 643 |
|
| 644 |
### Built By
|
| 645 |
|
| 646 |
**Track**: Building MCP (Enterprise)
|
| 647 |
**Author**: Kshitij Thakkar
|
| 648 |
+
**Powered by**: Google Gemini 2.5 Flash
|
| 649 |
+
**Built with**: Gradio (native MCP support)
|
| 650 |
|
| 651 |
---
|
| 652 |
|
app.py
CHANGED
|
@@ -98,19 +98,11 @@ def create_gradio_ui():
|
|
| 98 |
|
| 99 |
## MCP Connection
|
| 100 |
|
| 101 |
-
### Current Space (Development)
|
| 102 |
-
**HuggingFace Space**: `https://huggingface.co/spaces/kshitijthakkar/TraceMind-mcp-server`
|
| 103 |
-
|
| 104 |
-
**MCP Endpoint (Streamable HTTP - Recommended)**: `https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/`
|
| 105 |
-
|
| 106 |
-
**MCP Endpoint (SSE - Deprecated)**: `https://kshitijthakkar-tracemind-mcp-server.hf.space/gradio_api/mcp/sse`
|
| 107 |
-
|
| 108 |
-
### After Hackathon Submission
|
| 109 |
**HuggingFace Space**: `https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server`
|
| 110 |
|
| 111 |
-
**MCP Endpoint (
|
| 112 |
|
| 113 |
-
**MCP Endpoint (
|
| 114 |
""")
|
| 115 |
with gr.Tabs():
|
| 116 |
# Tab 1: Analyze Leaderboard
|
|
@@ -1136,11 +1128,11 @@ def create_gradio_ui():
|
|
| 1136 |
|
| 1137 |
This Gradio app is MCP-enabled. When deployed to HuggingFace Spaces, it can be accessed via MCP clients.
|
| 1138 |
|
| 1139 |
-
**
|
| 1140 |
|
| 1141 |
-
**
|
| 1142 |
|
| 1143 |
-
**MCP Endpoint (Streamable HTTP)**:
|
| 1144 |
|
| 1145 |
### What's Exposed via MCP:
|
| 1146 |
|
|
@@ -1187,7 +1179,8 @@ if __name__ == "__main__":
|
|
| 1187 |
logger.info("MCP Server: TraceMind Agent Evaluation Platform v1.0.0")
|
| 1188 |
logger.info("Protocol: Model Context Protocol (MCP)")
|
| 1189 |
logger.info("Transport: Gradio Native MCP Support (SSE)")
|
| 1190 |
-
logger.info("MCP Endpoint: https://
|
|
|
|
| 1191 |
logger.info("=" * 70)
|
| 1192 |
logger.info("Features:")
|
| 1193 |
logger.info(" β 7 AI-Powered Tools (Leaderboard + Trace + Cost + Dataset)")
|
|
@@ -1213,7 +1206,7 @@ if __name__ == "__main__":
|
|
| 1213 |
logger.info("=" * 70)
|
| 1214 |
logger.info("How to Connect (Claude Desktop/HF MCP Client):")
|
| 1215 |
logger.info(" 1. Go to https://huggingface.co/settings/mcp")
|
| 1216 |
-
logger.info(" 2. Add Space:
|
| 1217 |
logger.info(" 3. Start using TraceMind tools in your MCP client!")
|
| 1218 |
logger.info("=" * 70)
|
| 1219 |
logger.info("Starting Gradio UI + MCP Server on 0.0.0.0:7860...")
|
|
|
|
| 98 |
|
| 99 |
## MCP Connection
|
| 100 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 101 |
**HuggingFace Space**: `https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server`
|
| 102 |
|
| 103 |
+
**MCP Endpoint (SSE - Recommended)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse`
|
| 104 |
|
| 105 |
+
**MCP Endpoint (Streamable HTTP)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/`
|
| 106 |
""")
|
| 107 |
with gr.Tabs():
|
| 108 |
# Tab 1: Analyze Leaderboard
|
|
|
|
| 1128 |
|
| 1129 |
This Gradio app is MCP-enabled. When deployed to HuggingFace Spaces, it can be accessed via MCP clients.
|
| 1130 |
|
| 1131 |
+
**HuggingFace Space**: `https://huggingface.co/spaces/MCP-1st-Birthday/TraceMind-mcp-server`
|
| 1132 |
|
| 1133 |
+
**MCP Endpoint (SSE - Recommended)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse`
|
| 1134 |
|
| 1135 |
+
**MCP Endpoint (Streamable HTTP)**: `https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/`
|
| 1136 |
|
| 1137 |
### What's Exposed via MCP:
|
| 1138 |
|
|
|
|
| 1179 |
logger.info("MCP Server: TraceMind Agent Evaluation Platform v1.0.0")
|
| 1180 |
logger.info("Protocol: Model Context Protocol (MCP)")
|
| 1181 |
logger.info("Transport: Gradio Native MCP Support (SSE)")
|
| 1182 |
+
logger.info("MCP Endpoint (SSE): https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/sse")
|
| 1183 |
+
logger.info("MCP Endpoint (HTTP): https://mcp-1st-birthday-tracemind-mcp-server.hf.space/gradio_api/mcp/")
|
| 1184 |
logger.info("=" * 70)
|
| 1185 |
logger.info("Features:")
|
| 1186 |
logger.info(" β 7 AI-Powered Tools (Leaderboard + Trace + Cost + Dataset)")
|
|
|
|
| 1206 |
logger.info("=" * 70)
|
| 1207 |
logger.info("How to Connect (Claude Desktop/HF MCP Client):")
|
| 1208 |
logger.info(" 1. Go to https://huggingface.co/settings/mcp")
|
| 1209 |
+
logger.info(" 2. Add Space: MCP-1st-Birthday/TraceMind-mcp-server")
|
| 1210 |
logger.info(" 3. Start using TraceMind tools in your MCP client!")
|
| 1211 |
logger.info("=" * 70)
|
| 1212 |
logger.info("Starting Gradio UI + MCP Server on 0.0.0.0:7860...")
|