refactor: rename all gitcoffee references to gitea-mcp
This commit is contained in:
@@ -5,7 +5,7 @@ This guide explains how to set up GitCoffee MCP with per-agent Gitea account iso
|
|||||||
## Structure
|
## Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
gitcoffee-mcp/
|
gitea-mcp-mcp/
|
||||||
├── mcp/ # MCP server source code (Go)
|
├── mcp/ # MCP server source code (Go)
|
||||||
└── AGENTS.md # This file - OpenClaw setup guide
|
└── AGENTS.md # This file - OpenClaw setup guide
|
||||||
```
|
```
|
||||||
@@ -39,7 +39,7 @@ The GitCoffee MCP server provides Gitea tools via the Model Context Protocol (MC
|
|||||||
```bash
|
```bash
|
||||||
cd mcp
|
cd mcp
|
||||||
make build
|
make build
|
||||||
cp gitea-mcp ~/.bun/bin/gitcoffee-mcp
|
cp gitea-mcp ~/.bun/bin/gitea-mcp-mcp
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 2: Run Multiple MCP Instances
|
### Step 2: Run Multiple MCP Instances
|
||||||
@@ -48,10 +48,10 @@ Each agent needs its own MCP server instance with its own token:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Friday's MCP (runs on port 8081)
|
# Friday's MCP (runs on port 8081)
|
||||||
gitcoffee-mcp --host https://gitea.example.com --port 8081 --token <YOUR_GITEA_TOKEN> &
|
gitea-mcp-mcp --host https://gitea.example.com --port 8081 --token <YOUR_GITEA_TOKEN> &
|
||||||
|
|
||||||
# Karti's MCP (runs on port 8082)
|
# Karti's MCP (runs on port 8082)
|
||||||
gitcoffee-mcp --host https://gitea.example.com --port 8082 --token <YOUR_GITEA_TOKEN> &
|
gitea-mcp-mcp --host https://gitea.example.com --port 8082 --token <YOUR_GITEA_TOKEN> &
|
||||||
```
|
```
|
||||||
|
|
||||||
### Step 3: Configure MCP Servers in OpenClaw
|
### Step 3: Configure MCP Servers in OpenClaw
|
||||||
@@ -65,15 +65,15 @@ Add to `~/.openclaw/openclaw.json`:
|
|||||||
"acpx": {
|
"acpx": {
|
||||||
"config": {
|
"config": {
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"gitcoffee-friday": {
|
"gitea-mcp-friday": {
|
||||||
"command": "gitcoffee-mcp",
|
"command": "gitea-mcp-mcp",
|
||||||
"args": ["--host", "https://gitea.example.com", "--port", "8081"],
|
"args": ["--host", "https://gitea.example.com", "--port", "8081"],
|
||||||
"env": {
|
"env": {
|
||||||
"GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>"
|
"GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"gitcoffee-karti": {
|
"gitea-mcp-karti": {
|
||||||
"command": "gitcoffee-mcp",
|
"command": "gitea-mcp-mcp",
|
||||||
"args": ["--host", "https://gitea.example.com", "--port", "8082"],
|
"args": ["--host", "https://gitea.example.com", "--port", "8082"],
|
||||||
"env": {
|
"env": {
|
||||||
"GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>"
|
"GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>"
|
||||||
@@ -101,8 +101,8 @@ The key for isolation is `tools.allow/deny` per agent. This guarantees each agen
|
|||||||
"agentDir": "~/.openclaw/agents/friday/agent",
|
"agentDir": "~/.openclaw/agents/friday/agent",
|
||||||
"workspace": "/Users/karti/.openclaw/agents/friday/workspace",
|
"workspace": "/Users/karti/.openclaw/agents/friday/workspace",
|
||||||
"tools": {
|
"tools": {
|
||||||
"allow": ["gitcoffee-friday:*", "group:fs", "group:runtime"],
|
"allow": ["gitea-mcp-friday:*", "group:fs", "group:runtime"],
|
||||||
"deny": ["gitcoffee-karti:*"]
|
"deny": ["gitea-mcp-karti:*"]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@@ -111,8 +111,8 @@ The key for isolation is `tools.allow/deny` per agent. This guarantees each agen
|
|||||||
"agentDir": "~/.openclaw/agents/karti/agent",
|
"agentDir": "~/.openclaw/agents/karti/agent",
|
||||||
"workspace": "/Users/karti/.openclaw/agents/karti/workspace",
|
"workspace": "/Users/karti/.openclaw/agents/karti/workspace",
|
||||||
"tools": {
|
"tools": {
|
||||||
"allow": ["gitcoffee-karti:*", "group:fs", "group:runtime"],
|
"allow": ["gitea-mcp-karti:*", "group:fs", "group:runtime"],
|
||||||
"deny": ["gitcoffee-friday:*"]
|
"deny": ["gitea-mcp-friday:*"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
@@ -123,7 +123,7 @@ The key for isolation is `tools.allow/deny` per agent. This guarantees each agen
|
|||||||
**Key Points:**
|
**Key Points:**
|
||||||
- `allow`: What tools the agent CAN use
|
- `allow`: What tools the agent CAN use
|
||||||
- `deny`: What tools the agent CANNOT see/use
|
- `deny`: What tools the agent CANNOT see/use
|
||||||
- `gitcoffee-*:*` means all tools from that MCP server
|
- `gitea-mcp-*:*` means all tools from that MCP server
|
||||||
- `group:fs`, `group:runtime` are built-in tool groups
|
- `group:fs`, `group:runtime` are built-in tool groups
|
||||||
|
|
||||||
### Step 5: Add Agent Instructions (AGENTS.md per agent)
|
### Step 5: Add Agent Instructions (AGENTS.md per agent)
|
||||||
@@ -134,20 +134,20 @@ Create per-agent AGENTS.md to enforce behavior:
|
|||||||
```markdown
|
```markdown
|
||||||
# Friday Agent
|
# Friday Agent
|
||||||
|
|
||||||
You are the Friday Agent. You only have access to the gitcoffee-friday MCP server.
|
You are the Friday Agent. You only have access to the gitea-mcp-friday MCP server.
|
||||||
|
|
||||||
When performing Git operations, use only the gitcoffee-friday tools.
|
When performing Git operations, use only the gitea-mcp-friday tools.
|
||||||
Never attempt to use gitcoffee-karti or any other Gitea MCP server.
|
Never attempt to use gitea-mcp-karti or any other Gitea MCP server.
|
||||||
```
|
```
|
||||||
|
|
||||||
**Karti's workspace** (`~/.openclaw/agents/karti/workspace/AGENTS.md`):
|
**Karti's workspace** (`~/.openclaw/agents/karti/workspace/AGENTS.md`):
|
||||||
```markdown
|
```markdown
|
||||||
# Karti Agent
|
# Karti Agent
|
||||||
|
|
||||||
You are the Karti Agent. You only have access to the gitcoffee-karti MCP server.
|
You are the Karti Agent. You only have access to the gitea-mcp-karti MCP server.
|
||||||
|
|
||||||
When performing Git operations, use only the gitcoffee-karti tools.
|
When performing Git operations, use only the gitea-mcp-karti tools.
|
||||||
Never attempt to use gitcoffee-friday or any other Gitea MCP server.
|
Never attempt to use gitea-mcp-friday or any other Gitea MCP server.
|
||||||
```
|
```
|
||||||
|
|
||||||
## Available MCP Tools
|
## Available MCP Tools
|
||||||
@@ -179,10 +179,10 @@ Each MCP server provides these tools (prefixed with server name):
|
|||||||
Test with TUI for each agent:
|
Test with TUI for each agent:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Test Friday (should only see gitcoffee-friday tools)
|
# Test Friday (should only see gitea-mcp-friday tools)
|
||||||
openclaw tui --session friday --message "list available gitea tools"
|
openclaw tui --session friday --message "list available gitea tools"
|
||||||
|
|
||||||
# Test Karti (should only see gitcoffee-karti tools)
|
# Test Karti (should only see gitea-mcp-karti tools)
|
||||||
openclaw tui --session karti --message "list available gitea tools"
|
openclaw tui --session karti --message "list available gitea tools"
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -192,13 +192,13 @@ To add a new agent (e.g., "edith"):
|
|||||||
|
|
||||||
1. Run a new MCP instance:
|
1. Run a new MCP instance:
|
||||||
```bash
|
```bash
|
||||||
gitcoffee-mcp --host https://gitea.example.com --port 8083 --token <YOUR_GITEA_TOKEN> &
|
gitea-mcp-mcp --host https://gitea.example.com --port 8083 --token <YOUR_GITEA_TOKEN> &
|
||||||
```
|
```
|
||||||
|
|
||||||
2. Add to mcpServers in openclaw.json:
|
2. Add to mcpServers in openclaw.json:
|
||||||
```json
|
```json
|
||||||
"gitcoffee-edith": {
|
"gitea-mcp-edith": {
|
||||||
"command": "gitcoffee-mcp",
|
"command": "gitea-mcp-mcp",
|
||||||
"args": ["--host", "https://gitea.example.com", "--port", "8083"],
|
"args": ["--host", "https://gitea.example.com", "--port", "8083"],
|
||||||
"env": { "GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>" }
|
"env": { "GITEA_ACCESS_TOKEN": "<YOUR_GITEA_TOKEN>" }
|
||||||
}
|
}
|
||||||
@@ -210,8 +210,8 @@ gitcoffee-mcp --host https://gitea.example.com --port 8083 --token <YOUR_GITEA_T
|
|||||||
"id": "edith",
|
"id": "edith",
|
||||||
"name": "Edith Agent",
|
"name": "Edith Agent",
|
||||||
"tools": {
|
"tools": {
|
||||||
"allow": ["gitcoffee-edith:*", "group:fs", "group:runtime"],
|
"allow": ["gitea-mcp-edith:*", "group:fs", "group:runtime"],
|
||||||
"deny": ["gitcoffee-friday:*", "gitcoffee-karti:*"]
|
"deny": ["gitea-mcp-friday:*", "gitea-mcp-karti:*"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -188,7 +188,7 @@ func TestErrorTranslation_CreateCommitStatus(t *testing.T) {
|
|||||||
translated := gitea_errors.TranslateError(err, map[string]string{
|
translated := gitea_errors.TranslateError(err, map[string]string{
|
||||||
"operation": "CreateCommitStatus",
|
"operation": "CreateCommitStatus",
|
||||||
"owner": "karti-ai",
|
"owner": "karti-ai",
|
||||||
"repo": "gitcoffee",
|
"repo": "gitea-mcp",
|
||||||
"sha": "248ade7a9c...",
|
"sha": "248ade7a9c...",
|
||||||
"state": "success",
|
"state": "success",
|
||||||
"context": "ci/metal",
|
"context": "ci/metal",
|
||||||
|
|||||||
+1
-1
@@ -2,7 +2,7 @@
|
|||||||
set -e
|
set -e
|
||||||
|
|
||||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
BINARY_DIR="${HOME}/.cache/gitcoffee-mcp"
|
BINARY_DIR="${HOME}/.cache/gitea-mcp-mcp"
|
||||||
BINARY="$BINARY_DIR/gitea-mcp"
|
BINARY="$BINARY_DIR/gitea-mcp"
|
||||||
|
|
||||||
mkdir -p "$BINARY_DIR"
|
mkdir -p "$BINARY_DIR"
|
||||||
|
|||||||
Reference in New Issue
Block a user