mcp-ollama

你的朋友不会通过登录来认识你。你的家人、同事和运动队的队友也不会。他们是通过你多年来的表现来认识你的。十年前的你可能和现在的你看起来、听起来都截然不同，但你仍然是你。

软件问的依然是个狭隘的问题。登录界面上的密码。应用里的令牌。每一个都只检查此时此刻、在这个确切位置上，来者是否是正确的人，然后就不再过问。它看不见其间的一切，而那几乎就是你生活的全部。AI 工具让情况更糟，因为现在有一个工具会用你的名义写东西，而当有人问是谁授权了它时，这台机器上却无处可寻答案。

一个名字，名下的记录归你所有。 ~yourname 可用于所有支持该协议的工具，因此无需重复设置，也不必在任何时候粘贴密钥。记录中的内容来自你做过的事，而不是你亲手输入框中的内容，也不是模型猜出来的内容。你可以用一条命令切断对其中任何内容的访问。无需填写表格，也无需审核。

被读取，你就能获得报酬。任何人都可以免费查询你的用户名是否存在。要在确认你存在这一事实之外继续读取，就需要付费；这笔钱会付给你，由你决定谁能读取什么。集体也能以相同的条件持有记录，因为无论规模如何，记录的形式都一样；同一种形式可以承载你、你的团队和你的国家。工会、俱乐部、行业组织，或一群素未谋面的人，都可以为自己的成员背书，也能像读取你的记录一样读取他们的记录。

线程是你前往目标的方式。线程是你正在努力实现的目标。你可以自行认领一个，~Alter 可以根据它已能看到的内容为你创建一个，或者由某个集体授予你一个。被读取的是你为此努力时留下的轨迹，而不是最后拿到的一张证书。

以上只是简要概述。完整论述分为八章，详见 truealter.com/origin。其中的七十六项预测都经过精心设计，数据可以反过来证明它们不成立。其中五项确实被推翻了，这五项至今仍和其余预测一起公开发布。

这些内容不需要你盲目相信。把下面的内容交给你常用的 AI，让它用你自己的话带你了解。

Go to truealter.com, find the genesis and the origin papers, and read all of
them. Then start a discussion with me in my own language, no jargon.

Ask me one question at a time and wait for my answer. Follow what I am curious
about, not the order the site is written in.

Do not only read the pages. Connect to their interface directly and call
get_started. That tells you where I am and what comes next, and we work the
rest of this from there.

If I have a ~handle I will give it to you. If I do not and I decide I want
one, set it up with me here.

What I want to understand is what ~Alter is, how it applies to me, and what it
means for everyone else. Find me somewhere in it, and not the version written
for people who work in technology. Find the life nearest mine and walk me
through it, including what it would cost me.

Try to prove them wrong. Go and find where they show their working, and if
something is unclear or does not hold up, say so.

此项目未在任何地方发布镜像，因此以下每种方式都从构建此仓库开始。

docker build -t mcp-ollama .

Dockerfile 基于 node:20-alpine 构建，并已将 OLLAMA_HOST 设为 http://host.docker.internal:11434，因此容器会连接主机上的 Ollama，而不是 在容器内部寻找它。对于服务而言，该地址并非回环地址，因此回环地址限制会 拒绝连接，除非同时设置 MCP_OLLAMA_ALLOW_REMOTE=1，否则进程会在启动时退出。 镜像不会设置此变量，所以这里的每条命令都会设置它。

镜像还将 OLLAMA_MODEL 设为 hermes3:8b。添加 -e OLLAMA_MODEL=...， 即可改用其他默认模型。

Docker，适用于 macOS 和 Windows

docker run -i --rm -e MCP_OLLAMA_ALLOW_REMOTE=1 mcp-ollama

Docker，在 Linux 上

host.docker.internal 默认无法解析，因此需要将它映射到桥接网关。

docker run -i --rm \
  --add-host=host.docker.internal:host-gateway \
  -e MCP_OLLAMA_ALLOW_REMOTE=1 \
  mcp-ollama

Docker Compose

此仓库中附带了 docker-compose.yml，所以无需编写任何内容。文件中包含 extra_hosts 映射，因此同一个文件在 Linux 和 Docker Desktop 上都能使用。

此服务通过标准输入和标准输出使用 MCP，因此管道的另一端需要有客户端。docker compose up 启动服务时没有连接任何内容，于是它只会闲置。请使用 run，并添加 -T，这样 Compose 就不会干预管道。

docker compose run --rm -T mcp-ollama

将客户端指向它

MCP 客户端会自行启动服务，因此应将完整命令交给它，而不是交给一个已经运行的容器。

{
  "mcpServers": {
    "ollama": {
      "command": "docker",
      "args": ["compose", "-f", "/path/to/docker-compose.yml", "run", "--rm", "-T", "mcp-ollama"]
    }
  }
}

工具调用时出现 Ollama error 404

尚未拉取该模型。在 Shell 中运行 ollama pull <name>。local_pull 仅处理未标记的名称，因为它的验证器会拒绝标记中的冒号，例如 hermes3:8b 中的冒号。

出现 fetch failed 或连接被拒绝

Ollama 未运行，或者 OLLAMA_HOST 指向了错误的位置。使用 curl $OLLAMA_HOST/api/tags 检查。在容器内，localhost 指的是容器本身。

出现 OLLAMA_HOST must be loopback，且进程立即退出

这是防护机制在正常工作。将它指回 localhost，或者如果你确实要连接远程主机，则设置 MCP_OLLAMA_ALLOW_REMOTE=1。

调用速度很慢

冷启动的模型需要先加载，同一个 Ollama 进程之后的所有调用都会快得多。如果模型大于你的 VRAM 容量，Ollama 就会转而使用 CPU；运行 ollama ps 即可查看。

视觉调用占用大量内存或运行缓慢

local_vision 会将上下文限制为 8192，并有意让模型驻留 30 分钟。32K 上下文加上一张图像，在 7900 级别的显卡上会占用超过 23GB，并转而使用 CPU；这就是设置此上限的原因。

输出提前停止

请参阅工具部分中的令牌上限。大多数工具不接受 max_tokens。

除了连接到配置的 OLLAMA_HOST，它不会发起任何网络请求；默认情况下，该主机必须是 localhost、127.0.0.1 或 ::1。如果指定了非环回地址，程序会在启动时直接报错，而不会悄悄将你的提示词发送到别处；只有明确设置 MCP_OLLAMA_ALLOW_REMOTE=1 才能绕过此限制。如果你有意将它指向远程 Ollama，该端点的安全状态就由你负责。

没有遥测、分析、自动更新检查，软件包中也不包含模型权重。工具输入会按原样发送到 Ollama 的 HTTP API，响应则直接返回。传递给 local_pull 的模型名称在到达注册表端点之前，会根据 ^[a-z0-9][a-z0-9._/-]{0,127}$ 进行验证，因此调用者提供的字符串无法偏离这一路径。

有一处本地写入值得注意。如果 ~/.local/share/alter-runtime/lib/substrate-emit.sh 存在，每次生成都会向 ~/.local/share/alter-runtime/token-burn.jsonl 追加一行，记录工具、模型和令牌数量。此操作会以即发即弃的方式执行，失败时不报错，不会触及工具结果；如果未安装该辅助程序，则不会写入任何内容。

如需报告安全问题，请参阅 SECURITY.md。

这些记录格式属于开放的 Internet 草案，因此其他人的实现无需征求我们的许可，也能读取和写入与本实现相同的记录。以下是规定这些格式的草案。此服务本身并不实现这些格式，而是与实现它们的组件协同运行。

整个技术栈由 18 份草案构成。其余草案见 IETF datatracker。

一条身份通道，多种接入方式。

文档见 truealter.com/docs。

欢迎提交错误报告和小型补丁，详见 CONTRIBUTING.md。提交报告时，最好附上你调用的工具、调用它的客户端、路由到的模型、完整错误信息，以及 Node 和 Ollama 版本。如果要进行较大的设计变更，请先提出议题，以便在你投入时间之前商定范围。

mcp-ollama 保持精简，并会一直如此。将工作路由到本地 Ollama 进程，就是它的全部职责。

Apache 2.0。完整文本见 LICENSE。版权所有 2026 Alter Meridian Pty Ltd（ABN 54 696 662 049）。