个人代理工具服务器

TypeScript MCP服务器,用于个人可重复使用的代理工具,支持本地优先的stdio通信,提供安全的工具来发现个人技能和创建新的MCP工具模板。

  • by caboose-ai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 caboose-mcp/mcp-server

使用说明

mcp服务器

TypeScript MCP服务器,用于个人但可重用的代理工具。第一个版本是本地优先于stdio,并公开了用于发现个人技能和创建新MCP工具模板的安全工具。

需求

  • 布置
  • Bun,通过安装 mise install

设置

mise trust
mise install
bun install

命令

mise run dev        # run stdio MCP server
mise run test       # run unit tests
mise run typecheck  # TypeScript type check
mise run lint       # ESLint + Prettier checks
mise run build      # compile to dist/

MCP客户端配置

将编译后的二进制文件用于稳定的本地客户端:

mise run build
{
  "mcpServers": {
    "caboose-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"]
    }
  }
}

对于当地发展:

{
  "mcpServers": {
    "caboose-mcp-server": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/mcp-server/src/index.ts"]
    }
  }
}

技能根源

服务器索引 SKILL.md 这些默认根目录下的文件(如果存在):

  • $CODEX_HOME/skills
  • ~/.codex/skills
  • ~/.agents/skills

添加更多根 MCP_SKILL_ROOTS 使用操作系统路径分隔符,例如:

MCP_SKILL_ROOTS="/home/caboose/dev/ai-skills:/other/skills" mise run dev

默认情况下,模板创建仅限于当前工作目录。添加允许的输出根 MCP_TEMPLATE_OUTPUT_ROOTS.

工具

工具 目的
skills_list 列出发现的技能,包括名称、描述、路径和源根。
skills_read 阅读技能 SKILL.md 在根部密封检查之后。
skills_search 搜索发现的技能元数据和 SKILL.md 内容。
tool_template_create 在允许的输出根中创建一个启动TypeScript MCP工具模块。

下一个里程碑

通过包装或移植现有的仓库爬虫工具来添加仓库爬虫工具 repo-agent-guidance-generator 库存流。