    ](https://go.dev/)  ](https://hub.docker.com/r/sha1n/mcp-acdc-server)
mcp-acdc服务器
代理内容发现伴侣(ACDC)MCP服务器
一个高性能的模型上下文协议(MCP)服务器,用于AI代理发现和搜索本地内容。功能全文搜索由 成为双传输支持(stdio/SSE)和灵活的身份验证。
🌐 为什么选择ACDC?
ACDC解决了在AI代理空间中管理团队特定知识的挑战。虽然通用LLM功能强大,但它们缺乏团队特定工具、模式和标准的背景。
ACDC在您的内容存储库和AI代理之间提供了一座桥梁,使大规模管理和开发相关上下文变得容易。
部署模式
- 集中式(SSE): 对于大型团队,将ACDC部署为中央服务。整个组织的代理可以通过SSE接口进行连接,使知识管理透明一致。
- 本地化(stdio): 对于较小的团队或个人开发人员来说,在本地运行ACDC可能就足够了。将其指向Git管理的内容存储库,并根据需要提取更改。
Docker(快速入门):
cd examples/docker-local-content
docker-compose up -d自制:
brew install sha1n/tap/acdc-mcp
acdc-mcp --content-dir ./content✨ 特性
- 全文检索 --具有词干提取、模糊匹配和可配置增强功能的快速索引
- 动态资源发现 --自动扫描内容目录
- 动态提示发现 --自动扫描提示模板
- 符合MCP标准 --与AI代理无缝集成
- 双重运输 —
stdio对于本地代理商来说,sse用于远程/Docker - 认证 -可选的基本身份验证或API密钥保护
- 交叉平台的 --Linux、macOS和Windows
� 安装
码头工人
docker pull sha1n/mcp-acdc-server:latest家酿
brew install sha1n/tap/acdc-mcp从源代码构建
看 开发指南 获取构建说明。
🏃 跑步
标准传输(默认)
acdc-mcp --content-dir ./content苏格兰和南方能源公司运输
acdc-mcp --transport sse --content-dir ./content码头工人
docker run -p 8080:8080 \
-v $(pwd)/content:/app/content \
sha1n/mcp-acdc-server:latest健康检查(仅限SSE)
SSE服务器暴露了一个未经身份验证的 /health 返回的端点 200 OK。这可以用作Kubernetes中的活性或准备状态探测:
livenessProbe:
httpGet:
path: /health
port: 8080
readinessProbe:
httpGet:
path: /health
port: 8080⚙️ 配置
| 标志 | 短 | 环境变量 | 默认值 |
|---|---|---|---|
--content-dir | -c | ACDC_MCP_CONTENT_DIR | ./content |
--transport | -t | ACDC_MCP_TRANSPORT | stdio |
--port | -p | ACDC_MCP_PORT | 8080 |
--uri-scheme | -s | ACDC_MCP_URI_SCHEME | acdc |
--cross-ref | — | ACDC_MCP_CROSS_REF | false |
--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 |
有关包括身份验证在内的完整配置选项,请参阅 配置参考.
🤖 代理配置
Gemini CLI
音乐节目 :
gemini mcp add --scope user --transport stdio --trust acdc acdc-mcp -- --transport stdio --content-dir $ACDC_MCP_CONTENT_DIR上海证券交易所
gemini mcp add --scope user --transport sse --trust acdc http://:
/sse克劳德代码
音乐节目 :
claude mcp add --scope user --transport stdio acdc -- acdc-mcp --transport stdio --content-dir $ACDC_MCP_CONTENT_DIR上海证券交易所
claude mcp add --scope user --transport sse acdc http://:
/sse\[!注意\] 对于经过身份验证的服务器,提供所需的标头(Authorization或X-API-Key)作为客户端配置的一部分。
📚 内容与资源
服务器需要 mcp-metadata.yaml 内容目录中的文件,以定义服务器标识。工具元数据是可选的,服务器提供高质量的默认描述 search 和 read 工具。
有关编写资源文件的详细信息,包括frontmatter格式和搜索关键字增强,请参阅 创作资源指南.
例子
看看 示例/ 结构化部署模式目录:
🛠️ 发展
看 开发指南 用于构建、测试和贡献。
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
