@rotifer/mcp-server 0.1.1 → 0.1.2
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 +97 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# @rotifer/mcp-server
|
|
2
|
+
|
|
3
|
+
MCP (Model Context Protocol) server for the [Rotifer Protocol](https://rotifer.dev) Gene ecosystem. Lets AI agents search, inspect, compare, and rank Genes directly from any MCP-compatible IDE.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
### Cursor
|
|
8
|
+
|
|
9
|
+
Add to `.cursor/mcp.json`:
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"mcpServers": {
|
|
14
|
+
"rotifer": {
|
|
15
|
+
"command": "npx",
|
|
16
|
+
"args": ["-y", "@rotifer/mcp-server"]
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Claude Desktop
|
|
23
|
+
|
|
24
|
+
Add to `claude_desktop_config.json`:
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"mcpServers": {
|
|
29
|
+
"rotifer": {
|
|
30
|
+
"command": "npx",
|
|
31
|
+
"args": ["-y", "@rotifer/mcp-server"]
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Windsurf / Other MCP Clients
|
|
38
|
+
|
|
39
|
+
Use the same `npx` command — any client that supports MCP stdio transport will work.
|
|
40
|
+
|
|
41
|
+
## Tools
|
|
42
|
+
|
|
43
|
+
| Tool | Description |
|
|
44
|
+
|------|-------------|
|
|
45
|
+
| `search_genes` | Search the Gene ecosystem by name, domain, or description |
|
|
46
|
+
| `get_gene_detail` | Get detailed info about a specific Gene (phenotype, fitness, metadata) |
|
|
47
|
+
| `get_arena_rankings` | Get Arena rankings for a domain, sorted by F(g) fitness score |
|
|
48
|
+
| `compare_genes` | Side-by-side fitness comparison of 2–5 Genes |
|
|
49
|
+
|
|
50
|
+
### Examples
|
|
51
|
+
|
|
52
|
+
**Search for web search genes:**
|
|
53
|
+
|
|
54
|
+
> "Search for genes in the search.web domain"
|
|
55
|
+
|
|
56
|
+
**Find the best gene for a task:**
|
|
57
|
+
|
|
58
|
+
> "Show me Arena rankings for code.format"
|
|
59
|
+
|
|
60
|
+
**Compare two genes:**
|
|
61
|
+
|
|
62
|
+
> "Compare these two genes: [id-1] vs [id-2]"
|
|
63
|
+
|
|
64
|
+
## Configuration
|
|
65
|
+
|
|
66
|
+
Zero-config by default — connects to the public Rotifer Cloud API.
|
|
67
|
+
|
|
68
|
+
To use a custom endpoint, create `~/.rotifer/cloud.json`:
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"endpoint": "https://your-supabase-instance.supabase.co",
|
|
73
|
+
"anonKey": "your-anon-key"
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Or set environment variables:
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
ROTIFER_CLOUD_ENDPOINT=https://your-instance.supabase.co
|
|
81
|
+
ROTIFER_CLOUD_ANON_KEY=your-anon-key
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Requirements
|
|
85
|
+
|
|
86
|
+
- Node.js >= 20
|
|
87
|
+
|
|
88
|
+
## Links
|
|
89
|
+
|
|
90
|
+
- [Rotifer Protocol](https://rotifer.dev)
|
|
91
|
+
- [MCP Setup Guide](https://rotifer.dev/docs/guides/mcp-setup)
|
|
92
|
+
- [Gene Marketplace](https://rotifer.ai)
|
|
93
|
+
- [Protocol Specification](https://gitlab.com/rotifer-protocol/rotifer-spec)
|
|
94
|
+
|
|
95
|
+
## License
|
|
96
|
+
|
|
97
|
+
Apache-2.0
|