https://github.com/sha1n/mcp-acdc-server
Model Context Protocol (MCP) server that provides AI agents with searchable access to any markdown content through resources and an embedded full-text search tools.
https://github.com/sha1n/mcp-acdc-server
ai-tool knowledge-management mcp mcp-server model-context-protocol model-context-protocol-server
Last synced: about 1 month ago
JSON representation
Model Context Protocol (MCP) server that provides AI agents with searchable access to any markdown content through resources and an embedded full-text search tools.
- Host: GitHub
- URL: https://github.com/sha1n/mcp-acdc-server
- Owner: sha1n
- License: apache-2.0
- Created: 2026-01-19T17:41:21.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-01-26T06:26:41.000Z (about 1 month ago)
- Last Synced: 2026-01-27T22:47:10.415Z (about 1 month ago)
- Topics: ai-tool, knowledge-management, mcp, mcp-server, model-context-protocol, model-context-protocol-server
- Language: Go
- Homepage:
- Size: 175 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/sha1n/mcp-acdc-server/actions/workflows/ci.yml)
[](https://github.com/sha1n/mcp-acdc-server/actions/workflows/codeql-analysis.yml)
[](https://codecov.io/gh/sha1n/mcp-acdc-server)
[](https://goreportcard.com/report/github.com/sha1n/mcp-acdc-server)
[](https://go.dev/)
[](LICENSE)
[](https://hub.docker.com/r/sha1n/mcp-acdc-server)
# mcp-acdc-server
**Agent Content Discovery Companion (ACDC) MCP Server**
A high-performance Model Context Protocol (MCP) server for AI agents to discover and search local content. Features full-text search powered by [Bleve](https://github.com/blevesearch/bleve), dual transport support (stdio/SSE), and flexible authentication.
## 🌐 Why ACDC?
ACDC solves the challenge of managing team-specific knowledge in the AI agent space. While general-purpose LLMs are powerful, they lack the context of your team's specific tools, patterns, and standards.
ACDC provides a bridge between your content repositories and AI agents, making it easy to manage and develop relevant context at scale.
### Deployment Patterns
* **Centralized (SSE):** For large teams, deploy ACDC as a central service. Agents across the organization can connect via the SSE interface, making knowledge management transparent and consistent.
* **Localized (stdio):** For smaller teams or individual developers, running ACDC locally might be good enough. Point it at a Git-managed content repository and pull changes as needed.
**Docker (Quick Start):**
```bash
cd examples/docker-local-content
docker-compose up -d
```
**Homebrew:**
```bash
brew install sha1n/tap/acdc-mcp
acdc-mcp --content-dir ./content
```
## ✨ Features
- **Full-Text Search** — Fast indexing with stemming, fuzzy matching, and configurable boosting
- **Dynamic Resource Discovery** — Automatic scanning of content directories
- **Dynamic Prompt Discovery** — Automatic scanning of prompt templates
- **MCP Compliant** — Seamless integration with AI agents
- **Dual Transport** — `stdio` for local agents, `sse` for remote/Docker
- **Authentication** — Optional basic auth or API key protection
- **Cross-Platform** — Linux, macOS, and Windows
## � Installation
### Docker
```bash
docker pull sha1n/mcp-acdc-server:latest
```
### Homebrew
```bash
brew install sha1n/tap/acdc-mcp
```
### Build from Source
See [Development Guide](docs/development.md) for build instructions.
## 🏃 Running
### Stdio Transport (default)
```bash
acdc-mcp --content-dir ./content
```
### SSE Transport
```bash
acdc-mcp --transport sse --content-dir ./content
```
### Docker
```bash
docker run -p 8080:8080 \
-v $(pwd)/content:/app/content \
sha1n/mcp-acdc-server:latest
```
### Health Check (SSE Only)
The SSE server exposes an unauthenticated `/health` endpoint that returns `200 OK`. This can be used as a liveness or readiness probe in Kubernetes:
```yaml
livenessProbe:
httpGet:
path: /health
port: 8080
readinessProbe:
httpGet:
path: /health
port: 8080
```
## ⚙️ Configuration
| Flag | Short | Environment Variable | Default |
|------|-------|---------------------|---------|
| `--content-dir` | `-c` | `ACDC_MCP_CONTENT_DIR` | `./content` |
| `--transport` | `-t` | `ACDC_MCP_TRANSPORT` | `stdio` |
| `--port` | `-p` | `ACDC_MCP_PORT` | `8080` |
| `--search-max-results` | `-m` | `ACDC_MCP_SEARCH_MAX_RESULTS` | `10` |
| `--search-keywords-boost` | — | `ACDC_MCP_SEARCH_KEYWORDS_BOOST` | `3.0` |
| `--auth-type` | `-a` | `ACDC_MCP_AUTH_TYPE` | `none` |
For full configuration options including authentication, see [Configuration Reference](docs/configuration.md).
## 🤖 Agent Configuration
### [Gemini CLI](https://github.com/google-gemini/gemini-cli)
**Stdio:**
```bash
gemini mcp add --scope user --transport stdio --trust acdc acdc-mcp -- --transport stdio --content-dir $ACDC_MCP_CONTENT_DIR
```
**SSE:**
```bash
gemini mcp add --scope user --transport sse --trust acdc http://:/sse
```
### [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code)
**Stdio:**
```bash
claude mcp add --scope user --transport stdio acdc -- acdc-mcp --transport stdio --content-dir $ACDC_MCP_CONTENT_DIR
```
**SSE:**
```bash
claude mcp add --scope user --transport sse acdc http://:/sse
```
> [!NOTE]
> For authenticated servers, provide the required headers (`Authorization` or `X-API-Key`) as part of the client configuration.
## 📚 Content & Resources
The server requires an `mcp-metadata.yaml` file in your content directory to define server identity. Tool metadata is optional and the server provides high-quality default descriptions for `search` and `read` tools.
For details on authoring resource files, including frontmatter format and search keyword boosting, see the [Authoring Resources Guide](docs/authoring-resources.md).
### Examples
Check out the [examples/](examples/) directory for structured deployment patterns:
- [Local Content Demo](examples/docker-local-content/) — Direct mount for rapid iteration.
- [Remote Image Demo](examples/docker-image-content/) — Production-like init container pattern.
## 🛠️ Development
See [Development Guide](docs/development.md) for building, testing, and contributing.
## 📄 License
MIT License - see [LICENSE](LICENSE) for details.