MCP、OpenAPI、LSP 外部能力接入

SolonCode 可以把外部工具、业务接口和代码语义能力接入给 AI 使用。常见入口有三类：

• MCP：把工具或服务封装成 AI 可调用的工具。
• OpenAPI：把已有业务 REST 接口交给 AI 调用。
• LSP：让 AI 获得代码符号、定义、引用等语义理解能力。

本文只做总览、选择指南和最小配置。完整实战请继续阅读后续文章。

1、三者怎么选

简单判断：

• 你要接一个“工具生态”或“标准 Agent 工具服务”，优先 MCP。
• 你已有 OpenAPI 文档，想让 AI 调业务接口，优先 OpenAPI。
• 你想提升代码理解、符号定位和引用分析能力，启用 LSP。

2、Web 设置页管理（建议优先使用 Web 设置）

启动 Web：

soloncode web 0

进入设置页后，可以管理：

• MCP 服务器
• OpenAPI 服务器
• LSP 服务器
• 工具或接口启停
• 作用域与挂载

新用户建议优先用 Web 设置页添加、测试和启停外部能力；熟悉字段后再手写 YAML。

3、MCP 最小配置

本地进程 MCP

soloncode:
  mcpEnabled: true
  mcpServers:
    memory:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-memory"]
      enabled: true

HTTP Streamable MCP

soloncode:
  mcpEnabled: true
  mcpServers:
    remote-tools:
      type: "streamable"
      url: "https://example.com/mcp"
      headers:
        Authorization: "Bearer xxx"
      timeout: "120s"
      enabled: true

常用字段：

4、OpenAPI 最小配置

soloncode:
  openApiEnabled: true
  apiServers:
    order-service:
      docUrl: "https://order.example.com/openapi.json"
      apiBaseUrl: "https://order.example.com"
      headers:
        Authorization: "Bearer xxx"
      enabled: true

常用字段：

5、LSP 最小配置

Java

soloncode:
  lspEnabled: true
  lspServers:
    java:
      command: ["jdtls"]
      extensions: [".java"]
      enabled: true

TypeScript / JavaScript

soloncode:
  lspEnabled: true
  lspServers:
    typescript:
      command: ["typescript-language-server", "--stdio"]
      extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]
      enabled: true

Python

soloncode:
  lspEnabled: true
  lspServers:
    python:
      command: ["pyright-langserver", "--stdio"]
      extensions: [".py", ".pyi"]
      enabled: true

启用 LSP 前，需要先安装对应语言服务器。SolonCode 可以配置 LSP，但不会自动替你安装所有语言服务器。

6、组合示例

soloncode:
  mcpEnabled: true
  openApiEnabled: true
  lspEnabled: true

  mcpServers:
    memory:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-memory"]

  apiServers:
    user-service:
      docUrl: "https://api.example.com/openapi.json"
      apiBaseUrl: "https://api.example.com"
      headers:
        Authorization: "Bearer xxx"

  lspServers:
    java:
      command: ["jdtls"]
      extensions: [".java"]
    typescript:
      command: ["typescript-language-server", "--stdio"]
      extensions: [".ts", ".tsx", ".js", ".jsx"]

7、权限建议

外部能力接入前，先按下面顺序评估：

1. 是否真的需要接入。
2. 是否可以先只接只读能力。
3. 是否可以禁用写入、删除、付款、发消息等高风险接口。
4. Token 是否具备最小权限。
5. 是否需要在提示词或 AGENTS.md 中写明“写入前必须确认”。

更完整的安全建议见 38-卅八：权限与安全实践-让-AI-安全使用工具.md。

8、常见排障