Claude Code MCP Server 项目启动与配置教程

2025-05-29 13:12:01作者：董斯意

1. 项目的目录结构及介绍

Claude Code MCP Server 项目的目录结构如下：

claude-code-mcp/
├── assets/                     # 存放项目相关资源文件
├── docs/                       # 存放项目文档
├── scripts/                    # 存放项目脚本文件
├── src/                        # 存放项目源代码
├── .github/                    # GitHub 工作流和配置文件
├── .gitignore                  # 指定 Git 忽略的文件和目录
├── .npmignore                  # 指定 npm 忽略的文件和目录
├── .vscode/                    # Visual Studio Code 项目配置文件
├── AGENT.md                    # 项目 Agent 相关文档
├── CHANGELOG.md                # 项目更新日志
├── claude-code-mcp/            # 项目主目录
├── LICENSE                     # 项目许可证文件
├── README.md                   # 项目说明文件
├── RELEASE.md                  # 项目发布说明
├── package-lock.json           # npm 包锁定文件
├── package.json                # npm 包配置文件
├── print-eslint-config.js      # 打印 ESLint 配置文件的脚本
├── rules.devin.md              # 项目规则文件
├── start.bat                   # Windows 系统下启动项目的批处理文件
├── start.sh                    # Linux 系统下启动项目的脚本文件
├── test-standalone.js          # 独立运行的测试脚本
└── tsconfig.json               # TypeScript 配置文件

2. 项目的启动文件介绍

项目的启动文件包括 start.bat 和 start.sh，分别用于在 Windows 和 Linux 系统下启动项目。

start.bat：Windows 批处理文件，运行项目，通常在 Windows 系统下使用。
start.sh：Bash 脚本文件，运行项目，通常在 Linux 系统下使用。

这两个文件都会调用项目的主入口文件，通常为 src 目录下的某个 JavaScript 文件。

3. 项目的配置文件介绍

项目的配置文件主要包括以下两个：

package.json：npm 包的配置文件，定义了项目的依赖、脚本和配置。例如，可以定义启动脚本 start，如下所示：
```
"scripts": {
  "start": "node src/index.js"
}
```
这表示当运行 npm start 命令时，会使用 Node.js 运行 src/index.js 文件。
mcp.json 或 mcp_config.json：MCP 客户端的配置文件，用于配置 MCP 服务器的连接和工具。这个文件通常位于用户的主目录下的 .cursor 或 .codeium 目录中。例如：
```
{
  "claude_code": {
    "command": "claude_code",
    "args": ["--dangerously-skip-permissions"],
    "permissions": ["all"]
  }
}
```
这表示配置了 claude_code 工具，当 MCP 客户端调用此工具时，将使用 claude_code 命令并带有 --dangerously-skip-permissions 参数运行。