randonneuring-intelligence-mcp 0.1.0__tar.gz
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.
- randonneuring_intelligence_mcp-0.1.0/LICENSE +21 -0
- randonneuring_intelligence_mcp-0.1.0/MANIFEST.in +4 -0
- randonneuring_intelligence_mcp-0.1.0/PKG-INFO +274 -0
- randonneuring_intelligence_mcp-0.1.0/README.md +241 -0
- randonneuring_intelligence_mcp-0.1.0/pyproject.toml +66 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/PKG-INFO +274 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/SOURCES.txt +21 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/dependency_links.txt +1 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/entry_points.txt +2 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/requires.txt +8 -0
- randonneuring_intelligence_mcp-0.1.0/randonneuring_intelligence_mcp.egg-info/top_level.txt +1 -0
- randonneuring_intelligence_mcp-0.1.0/setup.cfg +4 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/__init__.py +18 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/__main__.py +33 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/config.py +74 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/data/audax_india/data.json +184307 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/data/audax_india/event_details.json +96044 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/data/audax_india/events.json +184307 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/data/lrm/data.json +353129 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/data/lrm/rider_aliases.json +2745 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/handlers.py +458 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/server.py +107 -0
- randonneuring_intelligence_mcp-0.1.0/src/randonneuring_mcp/tools.py +892 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 Prathap Pandian
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,274 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: randonneuring-intelligence-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: MCP server for randonneuring cycling event data analysis - exposes 53 tools for AI agents
|
|
5
|
+
Author-email: Prathap Pandian <mprathappandian@gmail.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/mprathappandian/randonneuring-intelligence-mcp
|
|
8
|
+
Project-URL: Repository, https://github.com/mprathappandian/randonneuring-intelligence-mcp
|
|
9
|
+
Project-URL: Issues, https://github.com/mprathappandian/randonneuring-intelligence-mcp/issues
|
|
10
|
+
Project-URL: Documentation, https://github.com/mprathappandian/randonneuring-intelligence-mcp#readme
|
|
11
|
+
Keywords: mcp,randonneuring,cycling,audax,model-context-protocol,ai,lrm
|
|
12
|
+
Classifier: Development Status :: 3 - Alpha
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
21
|
+
Classifier: Topic :: Scientific/Engineering :: Information Analysis
|
|
22
|
+
Requires-Python: >=3.10
|
|
23
|
+
Description-Content-Type: text/markdown
|
|
24
|
+
License-File: LICENSE
|
|
25
|
+
Requires-Dist: mcp>=1.0.0
|
|
26
|
+
Requires-Dist: randonneuring-intelligence>=0.1.0
|
|
27
|
+
Provides-Extra: dev
|
|
28
|
+
Requires-Dist: pytest>=7.4.0; extra == "dev"
|
|
29
|
+
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
30
|
+
Requires-Dist: black>=23.0.0; extra == "dev"
|
|
31
|
+
Requires-Dist: flake8>=6.0.0; extra == "dev"
|
|
32
|
+
Dynamic: license-file
|
|
33
|
+
|
|
34
|
+
# Randonneuring Intelligence MCP Server
|
|
35
|
+
|
|
36
|
+
[](https://badge.fury.io/py/randonneuring-intelligence-mcp)
|
|
37
|
+
[](https://www.python.org/downloads/)
|
|
38
|
+
[](https://opensource.org/licenses/MIT)
|
|
39
|
+
|
|
40
|
+
**AI-powered analysis of randonneuring cycling event data through Model Context Protocol (MCP)**
|
|
41
|
+
|
|
42
|
+
An MCP server that exposes **53 specialized tools** for analyzing randonneuring cycling events. Works with Kiro, Claude Desktop, and any MCP-compatible AI client.
|
|
43
|
+
|
|
44
|
+
## What is This?
|
|
45
|
+
|
|
46
|
+
This MCP server lets AI agents analyze randonneuring (long-distance cycling) event data through natural language. It provides:
|
|
47
|
+
|
|
48
|
+
- **21 LRM tools** - Worldwide Long Randonnée Medal results
|
|
49
|
+
- **32 Audax India tools** - Indian randonneuring event data
|
|
50
|
+
|
|
51
|
+
Ask questions like:
|
|
52
|
+
- "Show me all 1200km events in Maharashtra last year"
|
|
53
|
+
- "What's the completion rate for Paris-Brest-Paris?"
|
|
54
|
+
- "Which clubs organized the most events in 2023?"
|
|
55
|
+
|
|
56
|
+
The AI uses the appropriate tools to answer your questions.
|
|
57
|
+
|
|
58
|
+
## Quick Start
|
|
59
|
+
|
|
60
|
+
### Installation
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
pip install randonneuring-intelligence-mcp
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Configure in Kiro
|
|
67
|
+
|
|
68
|
+
Add to your Kiro MCP config (`C:\Users\<username>\.kiro\settings\mcp.json` on Windows):
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"mcpServers": {
|
|
73
|
+
"randonneuring-intelligence": {
|
|
74
|
+
"command": "randonneuring-mcp"
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Configure in Claude Desktop
|
|
81
|
+
|
|
82
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
|
83
|
+
|
|
84
|
+
```json
|
|
85
|
+
{
|
|
86
|
+
"mcpServers": {
|
|
87
|
+
"randonneuring-intelligence": {
|
|
88
|
+
"command": "randonneuring-mcp"
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### Restart Your AI Client
|
|
95
|
+
|
|
96
|
+
Restart Kiro or Claude Desktop to load the server.
|
|
97
|
+
|
|
98
|
+
## Features
|
|
99
|
+
|
|
100
|
+
### LRM (Long Randonnée Medal) - 21 Tools
|
|
101
|
+
|
|
102
|
+
**Filters (8 tools)**
|
|
103
|
+
- Filter by year, rider name, country, event, club, distance, gender, time
|
|
104
|
+
|
|
105
|
+
**Analysis (5 tools)**
|
|
106
|
+
- Rider statistics, club statistics, event statistics
|
|
107
|
+
- Time analysis, gender distribution
|
|
108
|
+
|
|
109
|
+
**Queries (6 tools)**
|
|
110
|
+
- List riders, clubs, events, countries, distances, years
|
|
111
|
+
|
|
112
|
+
### Audax India - 32 Tools
|
|
113
|
+
|
|
114
|
+
**Event Filters (7 tools)**
|
|
115
|
+
- Filter by year, club, location, state, distance, status, type
|
|
116
|
+
|
|
117
|
+
**Participant Filters (5 tools)**
|
|
118
|
+
- Filter by name, club, result status, medal, fee payment
|
|
119
|
+
|
|
120
|
+
**Analysis (6 tools)**
|
|
121
|
+
- Event statistics, club statistics, participant statistics
|
|
122
|
+
- Completion rates, state statistics, yearly trends
|
|
123
|
+
|
|
124
|
+
**Queries (8 tools)**
|
|
125
|
+
- List clubs, locations, states, distances, years
|
|
126
|
+
- List participants, participant clubs, rider numbers
|
|
127
|
+
|
|
128
|
+
## Example Queries
|
|
129
|
+
|
|
130
|
+
```
|
|
131
|
+
"Show me all 600km BRM events in Karnataka in 2023"
|
|
132
|
+
→ AI chains: audax_filter_by_year + audax_filter_by_distance + audax_filter_by_state
|
|
133
|
+
|
|
134
|
+
"What are the completion rates for different distances?"
|
|
135
|
+
→ AI calls: audax_get_completion_rates
|
|
136
|
+
|
|
137
|
+
"Show me John Smith's LRM statistics"
|
|
138
|
+
→ AI calls: lrm_get_rider_stats
|
|
139
|
+
|
|
140
|
+
"Which clubs have organized the most events?"
|
|
141
|
+
→ AI calls: audax_get_club_statistics
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## Data
|
|
145
|
+
|
|
146
|
+
The package includes bundled data files (~23 MB):
|
|
147
|
+
- LRM worldwide results
|
|
148
|
+
- Audax India event catalog with participant details
|
|
149
|
+
|
|
150
|
+
Data is loaded once at startup for fast query performance.
|
|
151
|
+
|
|
152
|
+
## Requirements
|
|
153
|
+
|
|
154
|
+
- Python 3.10 or higher
|
|
155
|
+
- Works with any MCP-compatible AI client:
|
|
156
|
+
- [Kiro](https://kiro.ai)
|
|
157
|
+
- [Claude Desktop](https://claude.ai/download)
|
|
158
|
+
- Custom MCP clients
|
|
159
|
+
|
|
160
|
+
## Architecture
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
AI Agent (Kiro/Claude)
|
|
164
|
+
↓
|
|
165
|
+
MCP Protocol (STDIO)
|
|
166
|
+
↓
|
|
167
|
+
This MCP Server
|
|
168
|
+
↓
|
|
169
|
+
randonneuring-intelligence (business logic)
|
|
170
|
+
↓
|
|
171
|
+
Bundled JSON Data Files
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## Development
|
|
175
|
+
|
|
176
|
+
### Install from Source
|
|
177
|
+
|
|
178
|
+
```bash
|
|
179
|
+
git clone https://github.com/mprathappandian/randonneuring-intelligence-mcp.git
|
|
180
|
+
cd randonneuring-intelligence-mcp
|
|
181
|
+
pip install -e .
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
### Run Tests
|
|
185
|
+
|
|
186
|
+
```bash
|
|
187
|
+
pip install -e ".[dev]"
|
|
188
|
+
pytest
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
## Advanced Configuration
|
|
192
|
+
|
|
193
|
+
### Custom Data Directory
|
|
194
|
+
|
|
195
|
+
Set environment variable to use your own data files:
|
|
196
|
+
|
|
197
|
+
```json
|
|
198
|
+
{
|
|
199
|
+
"mcpServers": {
|
|
200
|
+
"randonneuring-intelligence": {
|
|
201
|
+
"command": "randonneuring-mcp",
|
|
202
|
+
"env": {
|
|
203
|
+
"RANDONNEURING_DATA_DIR": "/path/to/your/data"
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### Debug Logging
|
|
211
|
+
|
|
212
|
+
```json
|
|
213
|
+
{
|
|
214
|
+
"mcpServers": {
|
|
215
|
+
"randonneuring-intelligence": {
|
|
216
|
+
"command": "randonneuring-mcp",
|
|
217
|
+
"env": {
|
|
218
|
+
"LOG_LEVEL": "DEBUG"
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## Troubleshooting
|
|
226
|
+
|
|
227
|
+
### Server Won't Start
|
|
228
|
+
|
|
229
|
+
1. Check Python version: `python --version` (must be 3.10+)
|
|
230
|
+
2. Verify installation: `pip show randonneuring-intelligence-mcp`
|
|
231
|
+
3. Test manually: `randonneuring-mcp` (should show startup logs)
|
|
232
|
+
|
|
233
|
+
### Tools Not Working
|
|
234
|
+
|
|
235
|
+
1. Check logs in your AI client's console
|
|
236
|
+
2. Enable debug logging (see Advanced Configuration)
|
|
237
|
+
3. Verify data files loaded (check startup logs)
|
|
238
|
+
|
|
239
|
+
### Import Errors
|
|
240
|
+
|
|
241
|
+
Ensure `randonneuring-intelligence` is installed:
|
|
242
|
+
```bash
|
|
243
|
+
pip install randonneuring-intelligence
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
## Project Links
|
|
247
|
+
|
|
248
|
+
- **PyPI**: https://pypi.org/project/randonneuring-intelligence-mcp/
|
|
249
|
+
- **GitHub**: https://github.com/mprathappandian/randonneuring-intelligence-mcp
|
|
250
|
+
- **Issues**: https://github.com/mprathappandian/randonneuring-intelligence-mcp/issues
|
|
251
|
+
|
|
252
|
+
## License
|
|
253
|
+
|
|
254
|
+
MIT License - see [LICENSE](LICENSE) file for details.
|
|
255
|
+
|
|
256
|
+
## Author
|
|
257
|
+
|
|
258
|
+
**Prathap Pandian**
|
|
259
|
+
- Email: mprathappandian@gmail.com
|
|
260
|
+
- GitHub: [@mprathappandian](https://github.com/mprathappandian)
|
|
261
|
+
|
|
262
|
+
## Acknowledgments
|
|
263
|
+
|
|
264
|
+
Built with:
|
|
265
|
+
- [Model Context Protocol](https://modelcontextprotocol.io) by Anthropic
|
|
266
|
+
- [randonneuring-intelligence](https://pypi.org/project/randonneuring-intelligence/) - Core data processing library
|
|
267
|
+
|
|
268
|
+
## Version History
|
|
269
|
+
|
|
270
|
+
### 0.1.0 (2024-11-18)
|
|
271
|
+
- Initial release
|
|
272
|
+
- 53 tools (21 LRM + 32 Audax India)
|
|
273
|
+
- Bundled data files
|
|
274
|
+
- Support for Kiro and Claude Desktop
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
# Randonneuring Intelligence MCP Server
|
|
2
|
+
|
|
3
|
+
[](https://badge.fury.io/py/randonneuring-intelligence-mcp)
|
|
4
|
+
[](https://www.python.org/downloads/)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
|
|
7
|
+
**AI-powered analysis of randonneuring cycling event data through Model Context Protocol (MCP)**
|
|
8
|
+
|
|
9
|
+
An MCP server that exposes **53 specialized tools** for analyzing randonneuring cycling events. Works with Kiro, Claude Desktop, and any MCP-compatible AI client.
|
|
10
|
+
|
|
11
|
+
## What is This?
|
|
12
|
+
|
|
13
|
+
This MCP server lets AI agents analyze randonneuring (long-distance cycling) event data through natural language. It provides:
|
|
14
|
+
|
|
15
|
+
- **21 LRM tools** - Worldwide Long Randonnée Medal results
|
|
16
|
+
- **32 Audax India tools** - Indian randonneuring event data
|
|
17
|
+
|
|
18
|
+
Ask questions like:
|
|
19
|
+
- "Show me all 1200km events in Maharashtra last year"
|
|
20
|
+
- "What's the completion rate for Paris-Brest-Paris?"
|
|
21
|
+
- "Which clubs organized the most events in 2023?"
|
|
22
|
+
|
|
23
|
+
The AI uses the appropriate tools to answer your questions.
|
|
24
|
+
|
|
25
|
+
## Quick Start
|
|
26
|
+
|
|
27
|
+
### Installation
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
pip install randonneuring-intelligence-mcp
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Configure in Kiro
|
|
34
|
+
|
|
35
|
+
Add to your Kiro MCP config (`C:\Users\<username>\.kiro\settings\mcp.json` on Windows):
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"mcpServers": {
|
|
40
|
+
"randonneuring-intelligence": {
|
|
41
|
+
"command": "randonneuring-mcp"
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Configure in Claude Desktop
|
|
48
|
+
|
|
49
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
{
|
|
53
|
+
"mcpServers": {
|
|
54
|
+
"randonneuring-intelligence": {
|
|
55
|
+
"command": "randonneuring-mcp"
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Restart Your AI Client
|
|
62
|
+
|
|
63
|
+
Restart Kiro or Claude Desktop to load the server.
|
|
64
|
+
|
|
65
|
+
## Features
|
|
66
|
+
|
|
67
|
+
### LRM (Long Randonnée Medal) - 21 Tools
|
|
68
|
+
|
|
69
|
+
**Filters (8 tools)**
|
|
70
|
+
- Filter by year, rider name, country, event, club, distance, gender, time
|
|
71
|
+
|
|
72
|
+
**Analysis (5 tools)**
|
|
73
|
+
- Rider statistics, club statistics, event statistics
|
|
74
|
+
- Time analysis, gender distribution
|
|
75
|
+
|
|
76
|
+
**Queries (6 tools)**
|
|
77
|
+
- List riders, clubs, events, countries, distances, years
|
|
78
|
+
|
|
79
|
+
### Audax India - 32 Tools
|
|
80
|
+
|
|
81
|
+
**Event Filters (7 tools)**
|
|
82
|
+
- Filter by year, club, location, state, distance, status, type
|
|
83
|
+
|
|
84
|
+
**Participant Filters (5 tools)**
|
|
85
|
+
- Filter by name, club, result status, medal, fee payment
|
|
86
|
+
|
|
87
|
+
**Analysis (6 tools)**
|
|
88
|
+
- Event statistics, club statistics, participant statistics
|
|
89
|
+
- Completion rates, state statistics, yearly trends
|
|
90
|
+
|
|
91
|
+
**Queries (8 tools)**
|
|
92
|
+
- List clubs, locations, states, distances, years
|
|
93
|
+
- List participants, participant clubs, rider numbers
|
|
94
|
+
|
|
95
|
+
## Example Queries
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
"Show me all 600km BRM events in Karnataka in 2023"
|
|
99
|
+
→ AI chains: audax_filter_by_year + audax_filter_by_distance + audax_filter_by_state
|
|
100
|
+
|
|
101
|
+
"What are the completion rates for different distances?"
|
|
102
|
+
→ AI calls: audax_get_completion_rates
|
|
103
|
+
|
|
104
|
+
"Show me John Smith's LRM statistics"
|
|
105
|
+
→ AI calls: lrm_get_rider_stats
|
|
106
|
+
|
|
107
|
+
"Which clubs have organized the most events?"
|
|
108
|
+
→ AI calls: audax_get_club_statistics
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Data
|
|
112
|
+
|
|
113
|
+
The package includes bundled data files (~23 MB):
|
|
114
|
+
- LRM worldwide results
|
|
115
|
+
- Audax India event catalog with participant details
|
|
116
|
+
|
|
117
|
+
Data is loaded once at startup for fast query performance.
|
|
118
|
+
|
|
119
|
+
## Requirements
|
|
120
|
+
|
|
121
|
+
- Python 3.10 or higher
|
|
122
|
+
- Works with any MCP-compatible AI client:
|
|
123
|
+
- [Kiro](https://kiro.ai)
|
|
124
|
+
- [Claude Desktop](https://claude.ai/download)
|
|
125
|
+
- Custom MCP clients
|
|
126
|
+
|
|
127
|
+
## Architecture
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
AI Agent (Kiro/Claude)
|
|
131
|
+
↓
|
|
132
|
+
MCP Protocol (STDIO)
|
|
133
|
+
↓
|
|
134
|
+
This MCP Server
|
|
135
|
+
↓
|
|
136
|
+
randonneuring-intelligence (business logic)
|
|
137
|
+
↓
|
|
138
|
+
Bundled JSON Data Files
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
## Development
|
|
142
|
+
|
|
143
|
+
### Install from Source
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
git clone https://github.com/mprathappandian/randonneuring-intelligence-mcp.git
|
|
147
|
+
cd randonneuring-intelligence-mcp
|
|
148
|
+
pip install -e .
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### Run Tests
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
pip install -e ".[dev]"
|
|
155
|
+
pytest
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
## Advanced Configuration
|
|
159
|
+
|
|
160
|
+
### Custom Data Directory
|
|
161
|
+
|
|
162
|
+
Set environment variable to use your own data files:
|
|
163
|
+
|
|
164
|
+
```json
|
|
165
|
+
{
|
|
166
|
+
"mcpServers": {
|
|
167
|
+
"randonneuring-intelligence": {
|
|
168
|
+
"command": "randonneuring-mcp",
|
|
169
|
+
"env": {
|
|
170
|
+
"RANDONNEURING_DATA_DIR": "/path/to/your/data"
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
### Debug Logging
|
|
178
|
+
|
|
179
|
+
```json
|
|
180
|
+
{
|
|
181
|
+
"mcpServers": {
|
|
182
|
+
"randonneuring-intelligence": {
|
|
183
|
+
"command": "randonneuring-mcp",
|
|
184
|
+
"env": {
|
|
185
|
+
"LOG_LEVEL": "DEBUG"
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
## Troubleshooting
|
|
193
|
+
|
|
194
|
+
### Server Won't Start
|
|
195
|
+
|
|
196
|
+
1. Check Python version: `python --version` (must be 3.10+)
|
|
197
|
+
2. Verify installation: `pip show randonneuring-intelligence-mcp`
|
|
198
|
+
3. Test manually: `randonneuring-mcp` (should show startup logs)
|
|
199
|
+
|
|
200
|
+
### Tools Not Working
|
|
201
|
+
|
|
202
|
+
1. Check logs in your AI client's console
|
|
203
|
+
2. Enable debug logging (see Advanced Configuration)
|
|
204
|
+
3. Verify data files loaded (check startup logs)
|
|
205
|
+
|
|
206
|
+
### Import Errors
|
|
207
|
+
|
|
208
|
+
Ensure `randonneuring-intelligence` is installed:
|
|
209
|
+
```bash
|
|
210
|
+
pip install randonneuring-intelligence
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
## Project Links
|
|
214
|
+
|
|
215
|
+
- **PyPI**: https://pypi.org/project/randonneuring-intelligence-mcp/
|
|
216
|
+
- **GitHub**: https://github.com/mprathappandian/randonneuring-intelligence-mcp
|
|
217
|
+
- **Issues**: https://github.com/mprathappandian/randonneuring-intelligence-mcp/issues
|
|
218
|
+
|
|
219
|
+
## License
|
|
220
|
+
|
|
221
|
+
MIT License - see [LICENSE](LICENSE) file for details.
|
|
222
|
+
|
|
223
|
+
## Author
|
|
224
|
+
|
|
225
|
+
**Prathap Pandian**
|
|
226
|
+
- Email: mprathappandian@gmail.com
|
|
227
|
+
- GitHub: [@mprathappandian](https://github.com/mprathappandian)
|
|
228
|
+
|
|
229
|
+
## Acknowledgments
|
|
230
|
+
|
|
231
|
+
Built with:
|
|
232
|
+
- [Model Context Protocol](https://modelcontextprotocol.io) by Anthropic
|
|
233
|
+
- [randonneuring-intelligence](https://pypi.org/project/randonneuring-intelligence/) - Core data processing library
|
|
234
|
+
|
|
235
|
+
## Version History
|
|
236
|
+
|
|
237
|
+
### 0.1.0 (2024-11-18)
|
|
238
|
+
- Initial release
|
|
239
|
+
- 53 tools (21 LRM + 32 Audax India)
|
|
240
|
+
- Bundled data files
|
|
241
|
+
- Support for Kiro and Claude Desktop
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68.0", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "randonneuring-intelligence-mcp"
|
|
7
|
+
version = "0.1.0"
|
|
8
|
+
description = "MCP server for randonneuring cycling event data analysis - exposes 53 tools for AI agents"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
authors = [{name = "Prathap Pandian", email = "mprathappandian@gmail.com"}]
|
|
11
|
+
license = {text = "MIT"}
|
|
12
|
+
requires-python = ">=3.10"
|
|
13
|
+
keywords = ["mcp", "randonneuring", "cycling", "audax", "model-context-protocol", "ai", "lrm"]
|
|
14
|
+
|
|
15
|
+
classifiers = [
|
|
16
|
+
"Development Status :: 3 - Alpha",
|
|
17
|
+
"Intended Audience :: Developers",
|
|
18
|
+
"License :: OSI Approved :: MIT License",
|
|
19
|
+
"Programming Language :: Python :: 3",
|
|
20
|
+
"Programming Language :: Python :: 3.10",
|
|
21
|
+
"Programming Language :: Python :: 3.11",
|
|
22
|
+
"Programming Language :: Python :: 3.12",
|
|
23
|
+
"Programming Language :: Python :: 3.13",
|
|
24
|
+
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
25
|
+
"Topic :: Scientific/Engineering :: Information Analysis",
|
|
26
|
+
]
|
|
27
|
+
|
|
28
|
+
dependencies = [
|
|
29
|
+
"mcp>=1.0.0",
|
|
30
|
+
"randonneuring-intelligence>=0.1.0",
|
|
31
|
+
]
|
|
32
|
+
|
|
33
|
+
[project.optional-dependencies]
|
|
34
|
+
dev = [
|
|
35
|
+
"pytest>=7.4.0",
|
|
36
|
+
"pytest-asyncio>=0.21.0",
|
|
37
|
+
"black>=23.0.0",
|
|
38
|
+
"flake8>=6.0.0",
|
|
39
|
+
]
|
|
40
|
+
|
|
41
|
+
[project.urls]
|
|
42
|
+
Homepage = "https://github.com/mprathappandian/randonneuring-intelligence-mcp"
|
|
43
|
+
Repository = "https://github.com/mprathappandian/randonneuring-intelligence-mcp"
|
|
44
|
+
Issues = "https://github.com/mprathappandian/randonneuring-intelligence-mcp/issues"
|
|
45
|
+
Documentation = "https://github.com/mprathappandian/randonneuring-intelligence-mcp#readme"
|
|
46
|
+
|
|
47
|
+
[project.scripts]
|
|
48
|
+
randonneuring-mcp = "randonneuring_mcp.__main__:main"
|
|
49
|
+
|
|
50
|
+
[tool.setuptools]
|
|
51
|
+
packages = ["randonneuring_mcp"]
|
|
52
|
+
|
|
53
|
+
[tool.setuptools.package-dir]
|
|
54
|
+
randonneuring_mcp = "src/randonneuring_mcp"
|
|
55
|
+
|
|
56
|
+
[tool.setuptools.package-data]
|
|
57
|
+
randonneuring_mcp = ["data/**/*.json"]
|
|
58
|
+
|
|
59
|
+
[tool.pytest.ini_options]
|
|
60
|
+
testpaths = ["tests"]
|
|
61
|
+
python_files = "test_*.py"
|
|
62
|
+
asyncio_mode = "auto"
|
|
63
|
+
|
|
64
|
+
[tool.black]
|
|
65
|
+
line-length = 100
|
|
66
|
+
target-version = ['py310', 'py311', 'py312']
|