AI导哈

MCP配置工具

mcpc是一个快速、交互式的CLI工具，用于管理和创建MCP服务器配置文件，支持多注册表、模板和验证功能。

  • by kaikenlabs
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 kaikenlabs/mcpc

使用说明


mcpc-MCP配置工具

用于管理的快速交互式CLI工具 模型上下文协议 服务器配置。

什么是mcpc？

mcpc 帮助您创建和管理 .mcp.json 通过浏览官方MCP服务器注册表来配置文件。使用交互式TUI搜索、选择和配置MCP服务器，而不是手动编写JSON配置。

特性

  • 🔍 交互式TUI -使用键盘导航浏览和搜索MCP注册表
  • ⚡ 智能缓存 -智能缓存快速启动（1小时TTL）
  • 📦 多注册表支持 -npm、PyPI、NuGet、Docker包
  • 🎯 模板 -跨项目保存和重用服务器配置
  • ✅ 验证 -验证现有 .mcp.json 文件
  • 🚀 交互式和CLI -使用TUI或命令行模式

作者的说明

每次我开始一个新项目时，我都必须复制或写入我的.mcp.json文件。在寻找具体信息时 MCP服务器，有时配置选项在文档中不太清楚。
我启动这个工具是为了让每个和我有同样问题的人都能更容易地完成这个过程。

出于好奇，这个项目完全由 克劳德代码. 无论出于何种目的，我90%的时间都是作为产品负责人，10%的时间是作为软件工程师，来纠正一些非常奇怪的问题 克劳德·科德正在做出的决定。

快速开始

安装

下载预构建的二进制文件：

# macOS (Intel)
curl -sL https://github.com/kaikenlabs/mcpc/releases/latest/download/mcpc_Darwin_x86_64.tar.gz | tar xz
sudo mv mcpc /usr/local/bin/

# macOS (Apple Silicon)
curl -sL https://github.com/kaikenlabs/mcpc/releases/latest/download/mcpc_Darwin_arm64.tar.gz | tar xz
sudo mv mcpc /usr/local/bin/

# Linux (amd64)
curl -sL https://github.com/kaikenlabs/mcpc/releases/latest/download/mcpc_Linux_x86_64.tar.gz | tar xz
sudo mv mcpc /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/kaikenlabs/mcpc/releases/latest/download/mcpc_Windows_x86_64.zip" -OutFile mcpc.zip
Expand-Archive mcpc.zip
# Add to PATH manually

或者使用Go安装：

go install github.com/kaikenlabs/mcpc@latest

或者从源代码构建：

git clone https://github.com/kaikenlabs/mcpc.git
cd mcpc
make tools
make build

基本用法

# Interactive mode - browse and select servers
mcpc init

# Search for specific servers
mcpc search filesystem

# Add a server non-interactively
mcpc add io.github.modelcontextprotocol/filesystem \
  --env BASE_PATH=/path/to/project

# Validate existing config
mcpc validate .mcp.json

# Use templates
mcpc template list
mcpc template apply my-dev-setup

如何

创建您的第一个配置

# 1. Start interactive mode
mcpc init

# 2. Use these keyboard shortcuts:
#    /      - Search for servers
#    Space  - Select/deselect
#    c      - Configure selected
#    w      - Write config
#    q      - Quit

# 3. Your .mcp.json is ready!

保存模板

# In interactive mode:
# 1. Select your servers
# 2. Press 't' to save as template
# 3. Name it (e.g., "python-dev")

# Reuse later:
mcpc template apply python-dev

添加单个服务器

# For npm packages
mcpc add @modelcontextprotocol/server-github \
  --env GITHUB_TOKEN=your_token

# For Python packages
mcpc add mcp-server-sqlite \
  --env DB_PATH=/path/to/database.db

# For Docker containers
mcpc add custom/mcp-server:latest \
  --env API_KEY=secret

验证配置

# Check if your .mcp.json is valid
mcpc validate

# Validate specific file
mcpc validate /path/to/config.mcp.json

清除缓存

# Clear cached registry data
mcpc cache clear

# View cache info
mcpc cache info

配置格式

mcpc 生成标准 .mcp.json 文件夹：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "env": {
        "BASE_PATH": "/Users/you/projects"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

键盘快捷键（交互模式）

关键 行动
/ 焦点搜索
Space 切换服务器选择
Enter 确认选择
c 配置所选服务器
w 将配置写入文件
t 将当前选择另存为模板
l 加载模板
Esc 回去吧
q 退出

存储位置

  • 配置: ~/.config/mcpc/ （模板、设置）
  • 缓存: ~/.cache/mcpc/ （注册表数据）
  • 输出: .mcp.json （在您的项目目录中）

发展

看 CLAUDE.md 用于开发设置和指南。

# Quick development setup
make tools            # Install dev tools
make build            # Build binary
make test             # Run tests
make lint             # Check code quality

# Release testing (local)
make release-check    # Validate goreleaser config
make release-snapshot # Build snapshot release
make release-test     # Test release without publishing

为什么选择mcpc？

在mcpc之前：

# Manual JSON editing, error-prone
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",  # Is this right?
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],  # What args?
      "env": {
        "BASE_PATH": "/path"  # What env vars are available?
      }
    }
  }
}

使用mcpc：

mcpc init
# Interactive TUI shows:
# - All available servers
# - Required environment variables
# - Package types and versions
# - Configuration templates

支持的包类型

  • npm → npx -y <package>
  • PyPI → uvx <package>
  • 纽吉特 → dotnet tool run <package>
  • 码头工人 → docker run <image>

需求

  • 转到1.25.3或更高版本
  • Internet连接（用于初始注册表获取）
  • 可选： graphviz （用于依赖关系图）

注册表

mcpc 使用MCP官方注册表：

  • APIhttps://registry.modelcontextprotocol.io
  • 文件：https://modelcontextprotocol.io

发布

每次合并时都会自动创建发布 main 使用：

  • 语义版本控制 （学期）
  • 约定式提交 对于版本碰撞：
    • fix: → 补丁（v1.0.0→ v1.0.1）
    • feat: → 未成年人（v1.0.0→ v1.1.0）
    • BREAKING CHANGE: 或 feat!: → 专业（v1.0.0→ v2.0.0）

查看所有版本： GitHub发布

许可证

GPL-3.0许可证-请参阅 许可证.md 详情

贡献

欢迎投稿！看 贡献.md 作为指导方针。

链接

由...制作❤️ 通过 凯肯实验室

相关 MCP