在 Linux 上安装

在 Linux（Ubuntu、Debian、Fedora、Arch 等）上安装和配置 ContextForge MCP 的完整指南。

前提条件

Node.js 18 或更高版本
通过包管理器安装，或使用 nvm（推荐）
Claude Desktop 或 Claude Code
从 claude.ai/download 下载 Claude Desktop
ContextForge 账户
Create a free account

安装 Node.js（如需）

选项 A：使用 nvm（推荐）

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Restart terminal, then install Node
nvm install --lts
nvm use --lts

选项 B：使用包管理器

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# Fedora
sudo dnf install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

第一步：安装 ContextForge MCP

打开终端并执行：

npm install -g contextforge-mcp

注意：如果遇到权限错误，请查看下方故障排除部分。请勿对 npm 使用 sudo。

第二步：验证安装

# Check if contextforge-mcp is installed
which contextforge-mcp

# Should output something like:
# /home/username/.nvm/versions/node/v20.x.x/bin/contextforge-mcp
# or /usr/local/bin/contextforge-mcp

选项 A：Claude Code（CLI）

快速配置向导

备选方案：手动命令

claude mcp add contextforge -s user -e CONTEXTFORGE_API_KEY=your-api-key-here -- npx -y contextforge-mcp

验证配置

# List configured MCPs
claude mcp list

# Or run verification
npx contextforge-setup --verify

选项 B：Claude Desktop

1. 找到配置文件

Linux 上的配置文件位置：

~/.config/Claude/claude_desktop_config.json

2. 创建目录和文件

# Create the directory if it doesn't exist
mkdir -p ~/.config/Claude

# Edit the config file
nano ~/.config/Claude/claude_desktop_config.json

3. 添加 ContextForge 配置

向文件中添加以下内容：

{
  "mcpServers": {
    "contextforge": {
      "command": "npx",
      "args": ["-y", "contextforge-mcp"],
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

注意：将 your-api-key-here 替换为你从仪表盘获取的实际 API key

4. 重启 Claude Desktop

完全关闭 Claude Desktop 后重新打开。

更新 ContextForge MCP

有新版本时，可以通过以下命令更新：

npm install -g contextforge-mcp

如果遇到问题或需要全新重装：

npm uninstall -g contextforge-mcp && npm install -g contextforge-mcp

更新后，请重启 Claude Desktop 或 Claude Code 会话以使更改生效。

Linux 故障排除

EACCES permission denied

请勿对 npm 使用 sudo。改为修复 npm 权限：

# Create a directory for global packages
mkdir -p ~/.npm-global

# Configure npm to use it
npm config set prefix '~/.npm-global'

# Add to PATH in ~/.bashrc or ~/.zshrc
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Now install again
npm install -g contextforge-mcp

command not found: contextforge-mcp

确保 npm bin 目录在 PATH 中：

# Find where npm installs global packages
npm config get prefix

# Add to your PATH in ~/.bashrc or ~/.zshrc
export PATH="$(npm config get prefix)/bin:$PATH"

Node.js 版本过旧

部分发行版附带旧版 Node.js。使用 nvm 获取最新版本：

# Check current version
node --version

# If < 18, install nvm and update
nvm install --lts
nvm use --lts

Linux 上无 Claude Desktop

如果你的发行版没有 Claude Desktop，请改用 Claude Code（CLI）。它在 Linux 上运行得非常好！