fix: update README with correct MCP setup (npm package)
- Changed from old stdio-server.js path to npx ra-h-mcp-server - Added local development alternative - Fixed tool list (removed rah_update_edge, added rah_list_dimensions) - Added HTTP method section for real-time UI updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.5
parent
bcea76800b
commit
fbbfb737ce
@@ -45,23 +45,42 @@ Open http://localhost:3000 → **Settings → API Keys** → add your OpenAI key
|
|||||||
|
|
||||||
## Connecting AI Agents via MCP
|
## Connecting AI Agents via MCP
|
||||||
|
|
||||||
RA-OS exposes an MCP server that external AI assistants can use to read/write your knowledge graph.
|
RA-OS includes an MCP server that lets Claude Code, Cursor, and other AI assistants read/write your knowledge graph.
|
||||||
|
|
||||||
### Claude Code Integration
|
### Quick Setup (Recommended)
|
||||||
|
|
||||||
Add to your Claude Code settings:
|
Add to your `~/.claude.json`:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"rah": {
|
"ra-h": {
|
||||||
"command": "node",
|
"command": "npx",
|
||||||
"args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
|
"args": ["ra-h-mcp-server"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**That's it.** Works without RA-OS running. Requires Node.js 18+.
|
||||||
|
|
||||||
|
### Alternative: Local Development
|
||||||
|
|
||||||
|
If you're developing RA-OS and want to use the local server:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"ra-h": {
|
||||||
|
"command": "node",
|
||||||
|
"args": ["/path/to/ra-h_os/apps/mcp-server-standalone/index.js"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
First install dependencies: `cd apps/mcp-server-standalone && npm install`
|
||||||
|
|
||||||
### Available MCP Tools
|
### Available MCP Tools
|
||||||
|
|
||||||
| Tool | Description |
|
| Tool | Description |
|
||||||
@@ -72,22 +91,28 @@ Add to your Claude Code settings:
|
|||||||
| `rah_get_nodes` | Get nodes by ID |
|
| `rah_get_nodes` | Get nodes by ID |
|
||||||
| `rah_create_edge` | Connect two nodes |
|
| `rah_create_edge` | Connect two nodes |
|
||||||
| `rah_query_edges` | Find connections |
|
| `rah_query_edges` | Find connections |
|
||||||
| `rah_update_edge` | Update a connection |
|
| `rah_list_dimensions` | List all dimensions |
|
||||||
| `rah_create_dimension` | Create a tag/category |
|
| `rah_create_dimension` | Create a tag/category |
|
||||||
| `rah_update_dimension` | Update a dimension |
|
| `rah_update_dimension` | Update a dimension |
|
||||||
| `rah_delete_dimension` | Delete a dimension |
|
| `rah_delete_dimension` | Delete a dimension |
|
||||||
| `rah_search_embeddings` | Semantic vector search |
|
|
||||||
|
|
||||||
### HTTP MCP Server
|
### HTTP MCP Server (Real-time UI updates)
|
||||||
|
|
||||||
For non-stdio clients, start the HTTP server:
|
If you want the RA-OS UI to update in real-time when nodes are created:
|
||||||
|
|
||||||
```bash
|
1. Start RA-OS: `npm run dev`
|
||||||
node apps/mcp-server/server.js
|
2. Use HTTP config:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"ra-h": {
|
||||||
|
"url": "http://127.0.0.1:44145/mcp"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Listens on `http://127.0.0.1:44145/mcp` by default.
|
|
||||||
|
|
||||||
## Project Layout
|
## Project Layout
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user