Inception MCP

初始mcp

一个包裹 开端的AERO v1 REST API，将语料库管理操作公开为MCP工具和CLI命令。

注释始终由INCEpTION界面内的人工注释器执行。 此包不进行注释：它处理语料库管理任务（上传、导出、监控、导入），这些任务可以自动化或委托给代理。

"Upload all .txt files in gutenberg/processed/ to project 1."
"Export annotations for document 42 by user admin in ctsv3 format to data/annot.tsv."

展示INCEpTION的AERO v1 REST API为：

• MCP工具 --可从任何MCP兼容代理（Claude Code、Claude Desktop等）调用
• 命令行界面 --独立终端接口，无需AI代理

两者共享相同的基础 InceptionClient.

用例

______________________________________________________________________

特性

支持的导出格式： ctsv3, xmi, xmi-struct, conllu, conll2003, conll2006, conll2009, conll2012, text, tcf, jsoncas, jsoncas-struct, nif.

______________________________________________________________________

需求

• Python≥3.10
• 正在运行的INCEpTION实例（用INCEpTION 33+测试） 启用REST API时 （见下文）
• uv （推荐）或 pip

______________________________________________________________________

启用INCEpTION REST API

在使用此软件包之前，必须启用AERO v1 REST API。请参阅 正式公司文件 以获取说明。

启用后，API可在 http://: /api/aero/v1Swagger用户界面可在以下网址获得：

http://:
/swagger-ui.html

身份验证使用HTTP基本身份验证和您的INCEpTION凭据。

______________________________________________________________________

安装

紫外线（推荐）

git clone https://github.com/RaphFaure/inception-mcp
cd inception-mcp
uv sync

使用pip

git clone https://github.com/RaphFaure/inception-mcp
cd inception-mcp
pip install -e .

______________________________________________________________________

配置

连接参数从环境变量（或 .env 项目根目录下的文件）：

创建一个 .env 文件：

cp .env.example .env
# then edit .env with your credentials

______________________________________________________________________

用法--MCP服务器

克劳德桌面版

将以下块添加到您的 ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "inception": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/inception-mcp", "inception-mcp"],
      "env": {
        "INCEPTION_URL": "http://localhost:8080",
        "INCEPTION_USER": "admin",
        "INCEPTION_PASSWORD": "your_password"
      }
    }
  }
}

重新启动克劳德桌面。INCEpTION工具将自动出现。

克劳德代码（Claude.ai/Code）

在下面添加相同的块 mcpServers 在您的项目中 .claude/settings.json 或在 ~/.claude/settings.json.

可用的MCP工具

项目

文件

注释

策展

______________________________________________________________________

用法--CLI

# via uv
uv run inception-cli 

# or, if installed via pip
inception-cli 

全局选项

--url       URL INCEpTION  (overrides $INCEPTION_URL)
--user      Username        (overrides $INCEPTION_USER)
--password  Password        (overrides $INCEPTION_PASSWORD)

命令

# Projects
inception-cli list-projects
inception-cli create-project --name my_project
inception-cli status --project 1
inception-cli export-project --project 1 --out backup.zip
inception-cli import-project --zip backup.zip
inception-cli delete-project --project 1

# Documents
inception-cli list-documents --project 1
inception-cli upload --project 1 --file doc.txt --format text
inception-cli batch-upload --project 1 --folder ./texts --glob "*.txt"
inception-cli export-doc-source --project 1 --doc 42 --out source.txt
inception-cli delete-doc --project 1 --doc 42

# Annotations
inception-cli list-annotations --project 1 --doc 42
inception-cli export --project 1 --doc 42 --user admin --format ctsv3 --out annot.tsv
inception-cli export-all --project 1 --user admin --out-dir ./annotations
inception-cli import-annotations --project 1 --doc 42 --user admin --file annot.tsv
inception-cli delete-annotations --project 1 --doc 42 --user admin

# Curation
inception-cli export-curation --project 1 --doc 42 --format ctsv3 --out curation.tsv
inception-cli delete-curation --project 1 --doc 42

______________________________________________________________________

建筑

inception_mcp/
├── __init__.py      # Public exports: InceptionClient, InceptionError
├── client.py        # InceptionClient — HTTP layer over AERO v1 REST API
├── server.py        # FastMCP server — wraps client as MCP tools
└── cli.py           # argparse CLI — wraps client as shell commands
tests/
└── test_client.py   # Unit tests (22 tests, no INCEpTION instance required)

client.py 是所有API调用的唯一真相来源。添加新操作意味着只需执行一次 InceptionClient，然后将其暴露在 server.py （作为a @mcp.tool())和in cli.py （作为一个新的子命令）。

使用以下工具运行测试：

pip install pytest
pytest tests/

______________________________________________________________________

安全说明

破坏性行动是不可逆转的。 delete_project, delete_document, delete_annotations 和 delete_curation INCEpTION中没有撤消机制。在调用ID之前，始终验证它们。

服务器在本地运行，只能从启动它的计算机访问。 凭据是从环境变量中读取的，永远不要将其硬编码在文件中 致力于版本控制。这 .gitignore 在此存储库中不包括 .env.

______________________________________________________________________

INCEpTION API参考

完整的AERO v1 Swagger用户界面可在以下网址获得：

http://:
/swagger-ui.html

______________________________________________________________________

许可证

麻省理工学院 --只要保留原始版权声明，您就可以在任何项目中自由使用、修改和重新分发此软件，无论是否商业化。