@with-thesis/mcp 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -0
- package/bin/thesis-mcp.mjs +3 -0
- package/dist/index.js +23401 -0
- package/dist/stdio.js +20202 -0
- package/package.json +49 -0
package/README.md
ADDED
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# @with-thesis/mcp
|
|
2
|
+
|
|
3
|
+
API-key-based MCP server for thesis sports data.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
Run it locally over stdio with an API key:
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
THESIS_API_KEY=th_live_xxx npx -y @with-thesis/mcp
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Claude Desktop example:
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"thesis": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "@with-thesis/mcp"],
|
|
21
|
+
"env": {
|
|
22
|
+
"THESIS_API_KEY": "th_live_xxx"
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Cursor example:
|
|
30
|
+
|
|
31
|
+
```json
|
|
32
|
+
{
|
|
33
|
+
"mcpServers": {
|
|
34
|
+
"thesis": {
|
|
35
|
+
"command": "npx",
|
|
36
|
+
"args": ["-y", "@with-thesis/mcp"],
|
|
37
|
+
"env": {
|
|
38
|
+
"THESIS_API_KEY": "th_live_xxx"
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
The MCP layer stays thin and forwards requests to the thesis API using the caller's API key.
|
|
46
|
+
|
|
47
|
+
## Hosted HTTP model
|
|
48
|
+
|
|
49
|
+
Customers connect to a hosted endpoint such as:
|
|
50
|
+
|
|
51
|
+
```txt
|
|
52
|
+
https://mcp.withthesis.dev/mcp
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Auth is bearer-token based today:
|
|
56
|
+
|
|
57
|
+
- `Authorization: Bearer th_live_xxx`
|
|
58
|
+
- `X-Thesis-API-Key: th_live_xxx`
|
|
59
|
+
- `X-API-Key: th_live_xxx`
|
|
60
|
+
|
|
61
|
+
## Local development
|
|
62
|
+
|
|
63
|
+
From the repo root:
|
|
64
|
+
|
|
65
|
+
```sh
|
|
66
|
+
bun run api:dev
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Remote HTTP dev server:
|
|
70
|
+
|
|
71
|
+
```sh
|
|
72
|
+
THESIS_API_URL=http://localhost:4000 \
|
|
73
|
+
THESIS_API_KEY=th_live_xxx \
|
|
74
|
+
MCP_ALLOW_ENV_AUTH_FALLBACK=true \
|
|
75
|
+
bun run mcp:dev:http
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Local stdio dev server:
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
THESIS_API_URL=http://localhost:4000 \
|
|
82
|
+
THESIS_API_KEY=th_live_xxx \
|
|
83
|
+
bun run mcp:dev:stdio
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Environment variables:
|
|
87
|
+
|
|
88
|
+
- `THESIS_API_URL`: optional, defaults to `https://api.withthesis.dev`
|
|
89
|
+
- `THESIS_API_KEY`: required for stdio
|
|
90
|
+
- `MCP_ALLOW_ENV_AUTH_FALLBACK`: optional, only for local HTTP dev when you want the server to use `THESIS_API_KEY` without an incoming auth header
|
|
91
|
+
- `PORT` or `MCP_PORT`: optional, defaults to `4100`
|
|
92
|
+
- `MCP_RATE_LIMIT_REQUESTS_PER_MIN`: optional coarse per-instance front-door rate limit, defaults to `300`
|
|
93
|
+
|
|
94
|
+
The hosted MCP service forwards requests to the main Thesis API. The MCP rate limiter is only a coarse front-door guard and does not replace the API's real auth, quota, or billing enforcement.
|
|
95
|
+
|
|
96
|
+
## Implemented tools
|
|
97
|
+
|
|
98
|
+
- `get_games`
|
|
99
|
+
- `get_game`
|
|
100
|
+
- `get_boxscore`
|
|
101
|
+
- `get_odds`
|
|
102
|
+
- `get_line_movement`
|
|
103
|
+
- `get_bookmakers`
|