使用 AI 编程¶

AgentScope Java 文档支持 llms.txt 标准，让 AI 编程助手能够理解框架文档并生成准确的代码。

什么是 llms.txt？¶

llms.txt 是一个专为大模型设计的文档索引文件，包含文档结构和关键页面说明，方便 AI 工具快速定位所需内容。

AgentScope Java 现在按版本提供文档入口：

文件	说明	URL
`v2/llms.txt`	AgentScope Java 2.0 文档索引	`https://java.agentscope.io/v2/llms.txt`
`v2/llms-full.txt`	AgentScope Java 2.0 单文件完整上下文	`https://java.agentscope.io/v2/llms-full.txt`
`v1/llms.txt`	AgentScope Java 1.x 文档索引	`https://java.agentscope.io/v1/llms.txt`
`v1/llms-full.txt`	AgentScope Java 1.x 单文件完整上下文	`https://java.agentscope.io/v1/llms-full.txt`

配置指南¶

Claude Code¶

Claude Code 可以通过 MCP 服务接入文档。

安装：

claude mcp add agentscope-docs -- uvx --from mcpdoc mcpdoc --urls AgentScopeJava:https://java.agentscope.io/v2/llms.txt

示例：

安装后可以直接提问：

如何用 AgentScope Java 创建一个工具？

Cursor¶

Cursor 支持两种接入方式。

方式一：添加文档（推荐）

打开 Cursor Settings -> Features -> Docs
点击 + Add new Doc
填入：https://java.agentscope.io/v2/llms-full.txt

方式二：MCP 服务

打开 Cursor Settings -> Tools & MCP
点击 New MCP Server 编辑 mcp.json
添加配置：

{
  "mcpServers": {
    "agentscope-docs": {
      "command": "uvx",
      "args": [
        "--from", "mcpdoc", "mcpdoc",
        "--urls", "AgentScopeJava:https://java.agentscope.io/v2/llms.txt"
      ]
    }
  }
}

示例：

参考 AgentScope 文档，写一个带天气查询工具的 ReActAgent。

Windsurf¶

Windsurf 可以通过 MCP 服务接入。

打开设置，进入 MCP 配置
添加服务：

{
  "mcpServers": {
    "agentscope-docs": {
      "command": "uvx",
      "args": [
        "--from", "mcpdoc", "mcpdoc",
        "--urls", "AgentScopeJava:https://java.agentscope.io/v2/llms.txt"
      ]
    }
  }
}

其他工具¶

支持文档/知识库的工具：

直接添加 https://java.agentscope.io/v2/llms-full.txt。

支持 MCP 的工具：

参考上面的 MCP 配置模板。

使用 AgentScope Java 1.x：

如果项目仍在使用 1.x，请改用：

https://java.agentscope.io/v1/llms.txt
https://java.agentscope.io/v1/llms-full.txt

环境要求：

MCP 方式需要先安装 uv。