Aum MCP Server

aum-mcp服务器

个人MCP服务器分为多个集中服务器，每个服务器只加载所需的工具，使Claude的上下文保持简洁。

______________________________________________________________________

设置

1.安装依赖项

npm install

2.配置环境

cp .env.example .env

填写 .env 使用API密钥。中的每个部分 .env.example 解释了在哪里生成它们。

谷歌（Gmail+日历+联系人） 填写后需要OAuth流 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET，运行：

node --env-file=.env scripts/google-auth.mjs

这打印了一个 GOOGLE_REFRESH_TOKEN --将其粘贴到 .env一个令牌覆盖了所有三个谷歌服务。

3.建造

npm run build

4.向Claude注册

添加 ~/.mcp.json （如果不存在，则创建它）。替换 /path/to/mcp-server 使用此仓库的绝对路径：

{
  "mcpServers": {
    "aum-developer": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/developer.js"
      ]
    },
    "aum-notes": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/notes-server.js"
      ]
    },
    "aum-communication": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/communication.js"
      ]
    },
    "aum-canvas": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/canvas-server.js"
      ]
    },
    "aum-personal": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/personal.js"
      ]
    },
    "aum-slurm": {
      "command": "node",
      "args": [
        "--env-file=/path/to/mcp-server/.env",
        "/path/to/mcp-server/dist/slurm.js"
      ]
    }
  }
}

您只能注册所需的服务器，每个服务器都是独立的。

______________________________________________________________________

工具参考

aum-developer

aum-notes

aum-communication

aum-canvas

aum-personal

aum-slurm

______________________________________________________________________

Ollama（当地LLM）

ollama_chat 运行一个完全本地的代理循环——不需要云。

先决条件： 奥拉玛 已安装并正在运行，至少有一个型号已被拉出。

ollama pull qwen2.5     # recommended — best tool use, fast
ollama pull llama3.2    # solid alternative
ollama serve            # start if not running as a service

ollama_chat 根据提示中的关键字自动选择一个集中的工具子集。破坏性工具(write_file, run_command, gmail_send等）从不自动路由——通过 tools 参数。

______________________________________________________________________

仪表盘

本地web UI运行在 http://localhost:4242 具有服务器状态、注册工具、API集成卡和注释查看器/编辑器。

npm run web

______________________________________________________________________

发展

npm run build                # compile all servers to dist/
npm run dev:developer        # run developer server with tsx
npm run dev:notes            # run notes server with tsx
npm run dev:communication    # run communication server with tsx
npm run dev:slurm            # run slurm server with tsx
npm run web                  # local dashboard

一直跑 npm run build 在重新启动Claude之前进行更改。

______________________________________________________________________

添加新工具

1. 创建 src/tools/mytool.ts:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

export function registerMyTools(server: McpServer) {
  server.tool("my_tool", "What it does", {
    param: z.string().describe("A parameter"),
  }, async ({ param }) => {
    return { content: [{ type: "text" as const, text: `result` }] };
  });
}

1. 导入并调用相关入口点(src/developer.ts, src/notes-server.ts等等）。

1. 添加到 TOOLS 数组in src/web.ts 对于仪表板。

1. 跑 npm run build.

______________________________________________________________________

笔记存储

注释保存在 ~/.aum-mcp/notes.json.