
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
https://acuvity.ai
https://acuvity.aihttps://acuvity.ai
https://bsky.app/profile/acuvity.bsky.social
描述: 用于Apache IoTDB数据库的MCP服务器及其工具
由Acuvity打包,并从apache/iotdb-mcp-server的原始https://github.com/apache/iotdb-mcp-server发布到我们的精选MCP服务器https://mcp.acuvity.ai。
快速链接:
| 特性 | 描述 |
|---|---|
| 隔离执行 | 所有工具在安全的容器化沙箱内运行,强制执行进程隔离,防止横向移动。 |
| 默认非root运行 | 遵循最小权限原则,最小化潜在安全漏洞的影响。 |
| 只读文件系统 | 确保运行时不可变性,防止未授权修改。 |
| 版本固定 | 通过锁定工具和依赖版本,保证部署的一致性和可复现性。 |
| CVE扫描 | 使用https://docs.docker.com/scout/持续扫描镜像中的已知漏洞,支持主动缓解。 |
| SBOM与溯源 | 通过嵌入元数据和可追溯的构建信息,提供完整的供应链透明度。 |
| 容器签名(Cosign) | 使用https://github.com/sigstore/cosign实现镜像签名,确保容器镜像的完整性和真实性。 |
Minibridge集成:https://github.com/acuvity/minibridge建立安全的代理到MCP连接,支持Rego/HTTP-based策略执行🕵️,并简化编排。
https://github.com/acuvity/mcp-servers-registry/tree/main容器包含https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-iotdb/docker/policy.rego,启用一组运行时https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-iotdb#️-guardrails,帮助执行服务的安全、隐私和正确使用。以下是提供的防护列表:
| 防护 | 摘要 |
|---|---|
resource integrity | 嵌入所有暴露资源的哈希值,确保其真实性,防止未授权修改,抵御供应链***和工具元数据的动态变更。 |
covert-instruction-detection | 检测请求中的隐藏或混淆指令。 |
sensitive-pattern-detection | 标记暗示敏感数据或文件系统暴露的模式。 |
shadowing-pattern-detection | 识别覆盖或影响其他工具描述的模式。 |
schema-misuse-prevention | 对输入数据强制执行严格的 schema 合规性。 |
cross-origin-tool-access | 控制对外部服务或API的调用。 |
secrets-redaction | 防止凭证或敏感值暴露。 |
basic authentication | 支持配置共享密钥,限制未授权访问MCP服务器,确保只有批准的客户端可以连接。 |
这些控制确保强大的运行时完整性,防止未授权行为,并为安全设计的系统操作提供基础。
[!NOTE] 默认情况下,除
resource integrity外的所有防护均关闭。您可以单独启用或禁用每个防护,确保仅激活您环境所需的保护。
维护者:
获取帮助:
提交问题:
支持架构:
amd64arm64基础镜像:
ghcr.io/astral-sh/uv:python3.12-alpine资源:
最新标签:
latest -> 1.0.0-cf77711 -> cf77711使用https://github.com/sigstore/cosign验证签名:
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-iotdb:latestcosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-iotdb:cf77711cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-iotdb:1.0.0-cf77711[!TIP] 鉴于mcp-server-iotdb的操作范围,它可以在任何地方托管。
环境变量和密钥:
IOTDB_HOST 必须设置IOTDB_PORT 可选(默认6667)IOTDB_USER 必须设置IOTDB_PASSWORD 必须设置IOTDB_DATABASE 必须设置IOTDB_SQL_DIALECT 可选(默认table)有关更多信息和额外配置,请参考https://github.com/apache/iotdb-mcp-server。
以下是配置大多数使用MCP提升Copilot体验的客户端的步骤。
[!NOTE] 这些集成在所有Minibridge模式下原生工作。为简洁起见,此处仅涵盖Docker本地运行设置。
要立即开始,您可以使用以下“一键”链接:
按ctrl + shift + p并输入Preferences: Open User Settings JSON,添加以下部分:
json{ "mcp": { "servers": { "acuvity-mcp-server-iotdb": { "env": { "IOTDB_DATABASE": "待设置", "IOTDB_HOST": "待设置", "IOTDB_PASSWORD": "待设置", "IOTDB_USER": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "IOTDB_HOST", "-e", "IOTDB_USER", "-e", "IOTDB_PASSWORD", "-e", "IOTDB_DATABASE", "docker.io/acuvity/mcp-server-iotdb:cf77711" ] } } } }
在您的工作区中创建一个名为.vscode/mcp.json的文件,并添加以下部分:
json{ "servers": { "acuvity-mcp-server-iotdb": { "env": { "IOTDB_DATABASE": "待设置", "IOTDB_HOST": "待设置", "IOTDB_PASSWORD": "待设置", "IOTDB_USER": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "IOTDB_HOST", "-e", "IOTDB_USER", "-e", "IOTDB_PASSWORD", "-e", "IOTDB_DATABASE", "docker.io/acuvity/mcp-server-iotdb:cf77711" ] } } }
要传递密钥,您应使用https://code.visualstudio.com/docs/copilot/chat/mcp-servers中描述的`promptString`输入类型。
在~/.codeium/windsurf/mcp_config.json中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-iotdb": { "env": { "IOTDB_DATABASE": "待设置", "IOTDB_HOST": "待设置", "IOTDB_PASSWORD": "待设置", "IOTDB_USER": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "IOTDB_HOST", "-e", "IOTDB_USER", "-e", "IOTDB_PASSWORD", "-e", "IOTDB_DATABASE", "docker.io/acuvity/mcp-server-iotdb:cf77711" ] } } }
更多信息请参见https://docs.windsurf.com/windsurf/mcp。
将以下JSON块添加到您的mcp配置文件:
~/.cursor/mcp.json.cursor/mcp.jsonjson{ "mcpServers": { "acuvity-mcp-server-iotdb": { "env": { "IOTDB_DATABASE": "待设置", "IOTDB_HOST": "待设置", "IOTDB_PASSWORD": "待设置", "IOTDB_USER": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "IOTDB_HOST", "-e", "IOTDB_USER", "-e", "IOTDB_PASSWORD", "-e", "IOTDB_DATABASE", "docker.io/acuvity/mcp-server-iotdb:cf77711" ] } } }
更多信息请参见https://docs.cursor.com/context/model-context-protocol。
在claude_desktop_config.json配置文件中添加以下部分:
json{ "mcpServers": { "acuvity-mcp-server-iotdb": { "env": { "IOTDB_DATABASE": "待设置", "IOTDB_HOST": "待设置", "IOTDB_PASSWORD": "待设置", "IOTDB_USER": "待设置" }, "command": "docker", "args": [ "run", "-i", "--rm", "--read-only", "-e", "IOTDB_HOST", "-e", "IOTDB_USER", "-e", "IOTDB_PASSWORD", "-e", "IOTDB_DATABASE", "docker.io/acuvity/mcp-server-iotdb:cf77711" ] } } }
更多信息请参见https://docs.anthropic.com/en/docs/agents-and-tools/mcp。
pythonasync with MCPServerStdio( params={ "env": {"IOTDB_DATABASE":"待设置","IOTDB_HOST":"待设置","IOTDB_PASSWORD":"待设置","IOTDB_USER":"待设置"}, "command": "docker", "args": ["run","-i","--rm","--read-only","-e","IOTDB_HOST","-e","IOTDB_USER","-e","IOTDB_PASSWORD","-e","IOTDB_DATABASE","docker.io/acuvity/mcp-server-iotdb:cf77711"] } ) as server: tools = await server.list_tools()
pythonasync with MCPServerSse( params={ "url": "http://<ip>:<port>/sse", } ) as server: tools = await server.list_tools()
更多信息请参见https://openai.github.io/openai-agents-python/mcp/。
在您的客户端配置中设置:
dockerrun -i --rm --read-only -e IOTDB_HOST -e IOTDB_USER -e IOTDB_PASSWORD -e IOTDB_DATABASE docker.io/acuvity/mcp-server-iotdb:cf77711直接运行:
consoledocker run -it -p 8000:8000 --rm --read-only -e IOTDB_HOST -e IOTDB_USER -e IOTDB_PASSWORD -e IOTDB_DATABASE docker.xuanyuan.run/acuvity/mcp-server-iotdb:cf77711
然后在您的应用/客户端中,可以配置为:
json{ "mcpServers": { "acuvity-mcp-server-iotdb": { "url": "http://localhost:8000/sse" } } }
您可能需要为不同工具使用不同端口。
本节假设您熟悉TLS和证书,需要:
- 带有与工具部署匹配的正确DNS/IP字段的服务器证书。
- 用于签署客户端证书的client-ca。
backend模式启动服务器:-e MINIBRIDGE_MODE=backend-v $PWD/certs:/certs)添加TLS证书(推荐)-e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem-e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem-e MINIBRIDGE_TLS_SERVER_KEY_PASS=可选-e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pemminibridge:在您的客户端配置中,Minibridge像任何其他STDIO命令一样工作。
Claude Desktop示例:
json{ "mcpServers": { "acuvity-mcp-server-iotdb": { "command": "minibridge", "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca/that/signed/the/server-cert.pem/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"] } } }
就是这样。
Minibridge提供了许多额外功能。如需分步指南,请访问wiki。如果有任何不清楚的地方,请随时联系我们!
此Chart需要一些必填信息才能安装。
必填密钥:
IOTDB_PASSWORD密钥需设置为secrets.IOTDB_PASSWORD,可通过.value或现有.valueFrom设置。必填环境变量:
IOTDB_HOST环境变量需通过env.IOTDB_HOST设置。IOTDB_USER环境变量需通过env.IOTDB_USER设置。IOTDB_DATABASE环境变量需通过env.IOTDB_DATABASE设置。可选环境变量:
IOTDB_PORT="%!s(int=6667)"可通过env.IOTDB_PORT="%!s(int=6667)"更改。IOTDB_SQL_DIALECT="table"可通过env.IOTDB_SQL_DIALECT="table"更改。您可以查看Chart的README:
consolehelm show readme oci://docker.io/acuvity/mcp-server-iotdb --version 1.0.0
您可以查看可配置的values:
CODE_TOKEN_11`
使用Helm安装:
consolehelm install mcp-server-iotdb oci://docker.io/acuvity/mcp-server-iotdb --version 1.0.0
之后,您的MCP服务器mcp-server-iotdb默认可通过集群内的Kubernetes Service mcp-server-iotdb在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行更改。
部署将创建一个带有healthPort的Kubernetes服务,用于活性探针和就绪探针。此健康端口也可用于您选择的监控栈,并在/metrics路径下暴露指标。
有关设置和运行时安全(包括防护激活)的更多详细信息,请参见完整的charts https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-iotdb/charts/mcp-server-iotdb/README.md。
有关此服务器提供的所有功能、工具、参数和SBOM哈希的详细列表,请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-iotdb
💬 有问题?打开issue或联系我们 *** 。 📦 欢迎贡献!
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务