sofos 0.2.1

An interactive AI coding agent for your terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

# MCP Server Examples

Common MCP server configurations for Sofos.

## Filesystem

```toml
[mcp-servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"]
```

## Databases

### PostgreSQL

```toml
[mcp-servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
```

### PostgreSQL with credentials

```toml
[mcp-servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user@localhost/mydb"]
env = { "PGPASSWORD" = "secret123" }
```

### SQLite

```toml
[mcp-servers.sqlite]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
```

## APIs

### GitHub

```toml
[mcp-servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { "GITHUB_TOKEN" = "ghp_YOUR_TOKEN" }
```

Get token: https://github.com/settings/tokens

### GitLab

```toml
[mcp-servers.gitlab]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-gitlab"]
env = { "GITLAB_TOKEN" = "glpat_YOUR_TOKEN" }
```

### Slack

```toml
[mcp-servers.slack]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-slack"]
env = { "SLACK_BOT_TOKEN" = "xoxb-YOUR-TOKEN", "SLACK_TEAM_ID" = "T1234567890" }
```

## Cloud Storage

### Google Drive

```toml
[mcp-servers.gdrive]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-google-drive"]
env = { "GOOGLE_APPLICATION_CREDENTIALS" = "/path/to/credentials.json" }
```

## Custom Servers

### HTTP Server

```toml
[mcp-servers.custom]
url = "https://api.example.com/mcp"
headers = { "Authorization" = "Bearer YOUR_TOKEN" }
```

### Python Server

```toml
[mcp-servers.python]
command = "python"
args = ["-m", "my_mcp_server"]
env = { "API_KEY" = "YOUR_KEY" }
```

### Custom Binary with Environment

```toml
[mcp-servers.company-internal]
command = "/usr/local/bin/company-mcp-server"
args = ["--config", "/etc/company/mcp-config.json"]
env = { "COMPANY_API_URL" = "https://internal.company.com", "LOG_LEVEL" = "debug" }
```

## Multiple Servers

```toml
[mcp-servers.docs]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]

[mcp-servers.projects]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Projects"]

[mcp-servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { "GITHUB_TOKEN" = "ghp_YOUR_TOKEN" }
```

## Config Locations

- **Global:** `~/.sofos/config.toml` - Shared across projects
- **Local:** `.sofos/config.local.toml` - Project-specific (overrides global)

## Tool Naming

MCP tools are prefixed with their server name:
- Server: `github`
- Tool: `create_issue`
- Available as: `github_create_issue`

## Resources

- All servers: https://github.com/modelcontextprotocol/servers
- Documentation: https://modelcontextprotocol.io/