Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .github/workflows/image.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,18 @@ jobs:
- mcp: wait
dockerfile: ./Dockerfile
context: ./
- mcp: think
dockerfile: ./Dockerfile
context: ./
- mcp: memory
dockerfile: ./Dockerfile
context: ./
- mcp: shell
dockerfile: ./shell/Dockerfile
context: ./
- mcp: sub-agent
dockerfile: ./Dockerfile
context: ./
- mcp: ssh
dockerfile: ./Dockerfile
context: ./
Expand Down Expand Up @@ -60,6 +66,9 @@ jobs:
- mcp: opencode
dockerfile: ./opencode/Dockerfile
context: ./
- mcp: codemogger
dockerfile: ./codemogger/Dockerfile
context: ./
permissions:
packages: write
contents: read
Expand Down
178 changes: 139 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,44 @@ mcp:
}
```

### 🤖 Codemogger Server

A codemogger MCP server that provides code analysis and indexing capabilities.

**Features:**
- Code search functionality
- Code indexing capabilities
- Reindex functionality
- JSON schema validation for inputs/outputs

**Tools:**
- `codemogger_search` - Search code using codemogger
- `codemogger_index` - Index code using codemogger
- `codemogger_reindex` - Reindex code using codemogger

**Docker Image:**
```bash
docker run ghcr.io/mudler/mcps/codemogger:latest
```

**LocalAI configuration ( to add to the model config):**
```yaml
mcp:
stdio: |
{
"mcpServers": {
"codemogger": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"ghcr.io/mudler/mcps/codemogger:master"
]
}
}
}
```


### 🌤️ Weather Server

A weather information server that provides current weather and forecast data for cities worldwide.
Expand Down Expand Up @@ -101,6 +139,56 @@ mcp:
}
```


### 🧠 Think Server

A no-op tool that forces the model to think about a message. Useful for debugging or forcing explicit reasoning steps in the model.

**Features:**
- Simple message input that gets echoed back
- Forces the model to explicitly process and think about the message
- Input validation (non-empty message)
- JSON schema validation for inputs/outputs

**Tool:**
- `think` - Think about a given message

**Input Format:**
```json
{
"message": "What is the capital of France?"
}
```

**Output Format:**
```json
{
"result": "Thinking about: What is the capital of France?"
}
```

**Docker Image:**
```bash
docker run ghcr.io/mudler/mcps/think:latest
```

**LocalAI configuration (to add to the model config):**
```yaml
mcp:
stdio: |
{
"mcpServers": {
"think": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"ghcr.io/mudler/mcps/think:master"
]
}
}
}
```

### ⏱️ Wait Server

A simple wait/sleep server that allows AI models to autonomously wait for a specified duration. Useful for waiting for asynchronous operations to complete.
Expand Down Expand Up @@ -494,6 +582,54 @@ mcp:

### 🔐 SSH Server

### 🤖 Sub-Agent Server

A Model Context Protocol (MCP) server that provides chat completion capabilities with background processing support.

**Features:**
- **Chat Completion Tool**: Send messages to OpenAI API with synchronous or asynchronous processing
- **Background Processing**: Execute chat completions in the background and retrieve results later
- **Task Management**: List active background tasks and get their results
- **TTL-based Cleanup**: Automatic cleanup of expired tasks based on configurable TTL

**Tools:**
- `sub_agent_chat` - Send a chat completion message to OpenAI
- `sub_agent_list` - List all active background sub-agent calls
- `sub_agent_get_result` - Get the result of a background task

**Configuration:**
- `OPENAI_BASE_URL` - Base URL for OpenAI API (default: `https://api.openai.com/v1`)
- `OPENAI_MODEL` - Model to use for completions (default: `gpt-4o-mini`)
- `OPENAI_API_KEY` - API key for OpenAI authentication (required)
- `SUB_AGENT_TTL` - TTL in hours for background task results (default: `4`)

**Docker Image:**
```bash
docker run -e OPENAI_API_KEY=your-api-key ghcr.io/mudler/mcps/sub-agent:latest
```

**LocalAI configuration (to add to the model config):**
```yaml
mcp:
stdio: |
{
"mcpServers": {
"sub-agent": {
"command": "docker",
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_MODEL": "gpt-4o-mini",
"SUB_AGENT_TTL": "4"
},
"args": [
"run", "-i", "--rm",
"ghcr.io/mudler/mcps/sub-agent:master"
]
}
}
}
```

An SSH server that allows AI models to connect to remote SSH hosts and execute shell scripts.

**Features:**
Expand Down Expand Up @@ -1471,45 +1607,9 @@ func main() {

Docker images are automatically built and pushed to GitHub Container Registry:

- `ghcr.io/mudler/mcps/duckduckgo:latest` - Latest DuckDuckGo server
- `ghcr.io/mudler/mcps/duckduckgo:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/duckduckgo:master` - Development versions
- `ghcr.io/mudler/mcps/weather:latest` - Latest Weather server
- `ghcr.io/mudler/mcps/weather:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/weather:master` - Development versions
- `ghcr.io/mudler/mcps/wait:latest` - Latest Wait server
- `ghcr.io/mudler/mcps/wait:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/wait:master` - Development versions
- `ghcr.io/mudler/mcps/memory:latest` - Latest Memory server
- `ghcr.io/mudler/mcps/memory:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/memory:master` - Development versions
- `ghcr.io/mudler/mcps/shell:latest` - Latest Shell server
- `ghcr.io/mudler/mcps/shell:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/shell:master` - Development versions
- `ghcr.io/mudler/mcps/ssh:latest` - Latest SSH server
- `ghcr.io/mudler/mcps/ssh:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/ssh:master` - Development versions
- `ghcr.io/mudler/mcps/homeassistant:latest` - Latest Home Assistant server
- `ghcr.io/mudler/mcps/homeassistant:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/homeassistant:master` - Development versions
- `ghcr.io/mudler/mcps/scripts:latest` - Latest Script Runner server
- `ghcr.io/mudler/mcps/scripts:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/scripts:master` - Development versions
- `ghcr.io/mudler/mcps/localrecall:latest` - Latest LocalRecall server
- `ghcr.io/mudler/mcps/localrecall:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/localrecall:master` - Development versions
- `ghcr.io/mudler/mcps/todo:latest` - Latest TODO server
- `ghcr.io/mudler/mcps/todo:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/todo:master` - Development versions
- `ghcr.io/mudler/mcps/mailbox:latest` - Latest Mailbox server
- `ghcr.io/mudler/mcps/mailbox:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/mailbox:master` - Development versions
- `ghcr.io/mudler/mcps/opencode:latest` - Latest Opencode server
- `ghcr.io/mudler/mcps/opencode:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/opencode:master` - Development versions
- `ghcr.io/mudler/mcps/filesystem:latest` - Latest Filesystem server
- `ghcr.io/mudler/mcps/filesystem:v1.0.0` - Tagged versions
- `ghcr.io/mudler/mcps/filesystem:master` - Development versions
- `ghcr.io/mudler/mcps/<component>:latest` - Latest component tagged version
- `ghcr.io/mudler/mcps/<component>:v<version>` - Specific tagged versions
- `ghcr.io/mudler/mcps/<component>:master` - Development versions

## Contributing

Expand Down
3 changes: 3 additions & 0 deletions codemogger/Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
FROM node:20-slim

ENTRYPOINT ["npx", "-y", "codemogger", "mcp"]
66 changes: 0 additions & 66 deletions go.mod

This file was deleted.

Loading
Loading