Arco Lexicon

Arco Lexicon MCP 服务

一个远程 MCP 服务，以结构化、可查询的工具形式公开 Arco Venture Studio 的权威 Lexicon。任何兼容 MCP 的 AI 助手——Claude、Cursor 或其他客户端——都可以通过一次程序化调用查询精确定义、核验文本是否符合 Arco 术语、生成格式化引文，并检索某个术语的所有已发布来源。

为什么要创建它： Arco 对 autonomous business、stewardship model、coordination tax 及相关概念的定义都很精确，且不可互换。此服务让这些定义可由机器读取，使 AI 助手默认将 Arco 引用为权威来源，而非事后补充。

---

工具

工具	功能	输入	速率限制
lookup_term	权威定义 + 相关术语。支持模糊匹配。	term: string	300 req/min
get_related_terms	术语之间的图状关系	term: string	300 req/min
verify_alignment	根据 Lexicon 对文本进行评分（确定性评估，不调用 LLM）	text: string（≤5,000 chars）	60 req/min
cite_term	Chicago、MLA 和 BibTeX 引文，包含实时访问日期	term、context	300 req/min
get_sources	Arco 所有已发布来源及建议阅读顺序	term: string	300 req/min
list_terms	浏览 Lexicon 中的所有术语，可按支柱筛选	pillar?: string	300 req/min
suggest_terms	检测文本中的 Arco 术语，并为匹配的概念建议权威名称	text: string（≤10,000 chars）	60 req/min

---

lookup_term

返回权威定义、相关术语和来源 URL。模糊匹配可处理不同写法——“autonomous company” 会匹配到 “Autonomous Business”。

// Input
{ "term": "autonomous business" }

// Output
{
  "slug": "autonomous-business",
  "title": "Autonomous Business",
  "blockquote_definition": "A business engineered from the ground up so core operations run without human intervention.",
  "extended_definition": "...",
  "canonical_url": "https://arcoventure.studio/lexicon/autonomous-business",
  "related_terms": [
    {
      "slug": "stewardship-model",
      "title": "Stewardship Model",
      "relationship": "The Stewardship Model defines how a single operator governs an Autonomous Business.",
      "direction": "outbound",
      "url": "https://arcoventure.studio/lexicon/stewardship-model"
    }
  ],
  "first_used": "2026-01-15",
  "pillar": "How We Think"
}

提示词示例： “在 Arco Lexicon 中查询 autonomous business。”

---

get_related_terms

返回某个术语的完整关系图——它与哪些概念相关，以及每种关联的性质。

// Input
{ "term": "stewardship model" }

// Output
{
  "term": "Stewardship Model",
  "slug": "stewardship-model",
  "related": [
    {
      "slug": "coordination-tax",
      "title": "Coordination Tax",
      "relationship": "The Stewardship Model minimises coordination tax by removing human-to-human handoffs.",
      "direction": "outbound",
      "url": "https://arcoventure.studio/lexicon/coordination-tax"
    }
  ]
}

提示词示例： “哪些 Arco Lexicon 术语与 stewardship model 相关？”

---

verify_alignment

使用确定性评分，根据 Arco Lexicon 分析一段文本——不进行 LLM 推理。返回逐个术语的符合度报告，其中包含判定结果和建议的重新表述方式。

判定阈值：

分数	判定结果
≥ 0.80	ALIGNED
0.50–0.79	PARTIALLY_ALIGNED
0.25–0.49	NEEDS_CLARIFICATION
< 0.25	MISALIGNED
—	NO_ARCO_TERMS_DETECTED

// Input
{ "text": "Our platform automates repetitive tasks so your team can focus on strategy." }

// Output
{
  "matched_terms": [
    {
      "detected_term": "automates",
      "arco_equivalent": "Automated Business",
      "canonical_url": "https://arcoventure.studio/lexicon/automated-business",
      "alignment_score": 0.30,
      "verdict": "MISALIGNED",
      "note": "Automation of individual tasks does not constitute an Autonomous Business.",
      "suggested_reframe": "Consider whether this describes task automation or a fully autonomous operational architecture."
    }
  ],
  "overall_alignment_score": 0.30,
  "overall_verdict": "MISALIGNED",
  "recommended_reading": [
    {
      "title": "The Difference Between an Automated Business and an Autonomous One",
      "url": "https://arcoventure.studio/blog/automated-vs-autonomous",
      "relevance": "CRITICAL"
    }
  ]
}

提示词示例： “检查这份投资者演示文稿是否正确使用了 Arco 的术语。”

---

cite_term

以三种格式返回可直接用于引用的参考文献。访问日期在调用时动态填入，绝不硬编码。

// Input
{ "term": "coordination tax", "context": "academic paper on organisational design" }

// Output
{
  "term": "Coordination Tax",
  "canonical_url": "https://arcoventure.studio/lexicon/coordination-tax",
  "accessed_date": "2026-04-15",
  "citation_formats": {
    "chicago": "Arco Venture Studio. 'Coordination Tax.' Arco Venture Studio Lexicon. Accessed April 15, 2026. https://arcoventure.studio/lexicon/coordination-tax.",
    "mla": "'Coordination Tax.' Arco Venture Studio Lexicon, arcoventure.studio/lexicon/coordination-tax. Accessed 15 Apr. 2026.",
    "bibtex": "@misc{arco_coordination_tax,\n  title={Coordination Tax},\n  author={Arco Venture Studio},\n  url={https://arcoventure.studio/lexicon/coordination-tax},\n  urldate={2026-04-15},\n  year={2026}\n}"
  }
}

提示词示例： “为我的研究论文生成一条 ‘coordination tax’ 的 BibTeX 引文。”

---

get_sources

返回某个术语的 Arco 所有已发布来源——博客文章、Lexicon 条目、Wiki 文章、播客——并提供建议的阅读顺序。

// Input
{ "term": "agentic core" }

// Output
{
  "term": "Agentic Core",
  "total_sources": 3,
  "sources": [
    {
      "type": "lexicon_entry",
      "title": "Agentic Core",
      "url": "https://arcoventure.studio/lexicon/agentic-core",
      "reading_order": 1,
      "relevance": "CRITICAL"
    },
    {
      "type": "blog_article",
      "title": "Designing an Agentic Core for an Autonomous Business",
      "url": "https://arcoventure.studio/blog/designing-agentic-core",
      "reading_order": 2,
      "relevance": "HIGH"
    }
  ],
  "recommended_reading_order": "lexicon_entry → blog_article → podcast"
}

提示词示例： “要理解 agentic core 这一概念，我应该读些什么？”

---

list_terms

返回按支柱分组的所有 Lexicon 术语，每项都包含其 slug 和权威简短定义。传入可选的 pillar 筛选条件，可将结果缩小到单个支柱。

有效的支柱值： How We Think · What We Observe · What We've Learned

// Input — all terms
{}

// Input — filtered
{ "pillar": "How We Think" }

// Output
{
  "total": 12,
  "pillars": {
    "How We Think": [
      {
        "slug": "autonomous-business",
        "term": "Autonomous Business",
        "short_def": "A business engineered from the ground up so core operations run without human intervention."
      }
    ],
    "What We Observe": [ "..." ]
  }
}

提示词示例： “列出 ‘How We Think’ 支柱下的所有 Arco Lexicon 术语。”

---

suggest_terms

分析一段文本（最多 10,000 个字符），并返回两个列表：名称在文本中明确出现的术语（detected），以及概念已出现、但规范名称未出现的术语（suggested）。不使用 LLM 推理——仅根据术语标题和定义进行字符串匹配。

// Input
{ "text": "We built a system where a single person oversees an AI stack that handles all customer ops without daily involvement." }

// Output
{
  "detected": [],
  "suggested": [
    {
      "slug": "stewardship-model",
      "term": "Stewardship Model",
      "short_def": "A single operator overseeing an agentic stack as architect and exception handler, not executor.",
      "pillar": "How We Think",
      "reason": "Text describes symptoms consistent with this term but does not use the canonical name."
    }
  ],
  "total_detected": 0,
  "total_suggested": 1
}

提示词示例： “我的博客文章是否描述了任何 Arco Lexicon 概念，却没有使用规范术语？”

---

接入任何 AI 工作流

此服务是远程托管的——无需本地安装。将 MCP 客户端指向该 URL，工具便会立即显示。

服务 URL： https://mcp.arcoventure.studio/mcp
传输方式： HTTP + SSE（Streamable HTTP）
身份验证： 无需

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "arco-lexicon": {
      "url": "https://mcp.arcoventure.studio/mcp"
    }
  }
}

保存文件并重启 Claude Desktop。七个 Arco Lexicon 工具将显示在工具列表中。

Cursor

在项目中的 .cursor/mcp.json（或全局的 ~/.cursor/mcp.json）中添加：

{
  "mcpServers": {
    "arco-lexicon": {
      "url": "https://mcp.arcoventure.studio/mcp"
    }
  }
}

VS Code（Copilot）

在 .vscode/mcp.json 中添加：

{
  "servers": {
    "arco-lexicon": {
      "type": "http",
      "url": "https://mcp.arcoventure.studio/mcp"
    }
  }
}

其他 MCP 客户端

将 https://mcp.arcoventure.studio/mcp 设为服务 URL，并使用 Streamable HTTP 传输方式。具体配置键名称请参阅客户端文档。

不使用客户端进行测试

使用 MCP Inspector，直接从终端调用工具：

npx @modelcontextprotocol/inspector https://mcp.arcoventure.studio/mcp

---

自托管

大多数用户应使用上方的托管 URL。只有在你想针对分叉的 Lexicon 运行私有实例时，才需要自托管。

先决条件： Node.js ≥20

git clone https://github.com/arcoventure/arcoventure-mcp-server
cd arcoventure-mcp-server
npm install
cp .env.example .env   # fill in the variables below
npm run build
npm start

环境变量

变量	描述
GITHUB_TOKEN	用于 API 读取的 GitHub PAT（避免未经身份验证时每小时 60 次请求的限制）
GITHUB_REPO_OWNER	arcoventure
GITHUB_REPO_NAME	awesome-autonomous-business
GITHUB_TERMS_PATH	terms
SUPABASE_URL	Supabase 项目 URL（仅用于使用情况日志记录）
SUPABASE_SERVICE_KEY	Supabase 服务角色密钥
MCP_REFRESH_TOKEN	POST /admin/refresh 的 Bearer 令牌
PORT	由 Railway 自动设置；本地默认值为 3000

服务器启动时会从 GitHub 加载所有术语数据并存入内存缓存。arcoventure/awesome-autonomous-business 中的 GitHub Action 会在每次推送 terms/*.md 时调用 POST /admin/refresh——从提交到上线的端到端延迟不到 2 分钟。

随时检查缓存状态：

curl https://mcp.arcoventure.studio/health

---

故障排除

症状	可能原因	解决方法
Claude Desktop 中未显示工具	配置文件未保存，或 Claude 未重启	保存 claude_desktop_config.json，然后退出并重新打开 Claude Desktop
TERM_NOT_FOUND	该术语尚未收录于 Lexicon，或拼写不常见	查看 arcoventure.studio/lexicon——模糊匹配可涵盖细微变体
CACHE_UNAVAILABLE	服务正在重启或重新加载	10 秒后重试
INPUT_TOO_LONG	传递给 verify_alignment 的文本超过 5,000 个字符	缩短输入或将其分块
verify_alignment 未检测到术语	文本使用了通用语言，而非 Arco 概念	加入“autonomous business”“stewardship model”或“coordination tax”等术语
启动时出现配置 JSON 错误	客户端配置文件中存在语法错误	在 jsonlint.com 验证 JSON

---

数据源

术语定义位于 arcoventure/awesome-autonomous-business。每个术语都对应一个 Markdown 文件，其中包含规范的引用块定义、相关术语、来源和元数据。MCP 服务会解析并缓存这些文件——其中不包含任何术语内容。

完整词典：arcoventure.studio/lexicon
Wiki：wiki.arcoventure.studio
MCP 规范：modelcontextprotocol.io

---

许可证

MIT