用途：配置 Serena MCP 服务器，分为机器级全局配置与仓库级项目配置两层，每层可覆盖或扩展上一层。
主要能力：全局配置位于 ~/.serena/serena_config.yml，用于设置所有项目的默认语言后端、默认工具与模式、全局忽略规则、语言服务器调优；项目配置位于 <repo>/.serena/project.yml，用于按仓库覆盖语言、忽略规则、写权限、monorepo 工作区文件夹及新增模式。上下文与模式是可组合的工具集/提示预设，可在全局、项目或启动时设置；serena start-mcp-server 的 CLI 参数可覆盖或扩展以上所有配置。
使用方式：Serena 会自动创建两个配置文件并带合理默认值，多数仓库无需修改。仅在出现具体症状时调整：monorepo 跨包符号解析失败改项目 additional_workspace_folders；find_symbol 返回错误语言或启动报 LSP 错误改项目 languages；vendor/、node_modules/、dist/、生成代码造成符号搜索泛滥改项目 ignored_paths；仓库只读改项目 read_only: true；工具集与运行环境不匹配改全局 --context；需要仅规划或无记忆行为改全局 modes；自装 LSP 或需固定版本改 ls_specific_settings。不要手工从零创建配置，应让 Serena 引导生成后再编辑，并保留内联注释与新版字段。编辑后用 serena print-system-prompt "$(pwd)" 验证解析结果，再用 find_symbol 探测 LSP；改动后 LSP 异常可删除 .serena/cache/ 强制重建，部分服务器还需重启 MCP 服务器。
适用场景与限制：适用于调整单仓库语言、monorepo 交叉引用、忽略目录、只读仓库、上下文与模式选择、自装语言服务器及数据目录迁移等。若上述症状均不适用，应保持默认配置不动。资料未提供具体收费、价格与平台信息。