Therefore MCP

MCP文档知识

提供方 Fybre

文档知识 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

一个Python MCP服务器,通过WebAPI将AI助手连接到Therefore™文档管理系统,支持文档CRUD、查询、工作流管理等9组工具。

一句话选型结论

按资料字段整理

Therefore MCP 属于文档知识类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 9 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量9暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文档管理Python本地部署AI集成多租户工作流自动化Python工具

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python3 src/mcp_server.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 9 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 9 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Therefore MCP当前 9 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Fybre上游标注的维护方 Fybre
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.1 KB
来自项目仓库与上游目录的原文,未做删改

因此,mcp

蟒蛇 主控程序 将AI助手连接到 因此™ 文档管理系统通过其WebAPI。

暴露 9组工具 涵盖文档CRUD、查询、工作流管理、关键字词典、用户管理、类别和系统操作。通过每个客户端的访问控制和审计日志记录支持多租户部署。stdio模式零外部依赖——纯Python标准库。

快速开始

先决条件

  • Python 3.9+
  • 一个具有WebAPI访问权限的实例
  • MCP兼容客户端(Claude Code、Claude Desktop、Codex、Cursor等)

配置

创建一个 .env.local 在项目根(或点)中 THEREFORE_ENV_PATH 在另一条路径上):```env
THEREFORE_TENANTS=mytenant
THEREFORE_DEFAULT_TENANT=mytenant

THEREFORE_MYTENANT_BASE_URL=https://mytenant.thereforeonline.com/theservice/v0001/restun
THEREFORE_MYTENANT_AUTH_METHOD=Basic
THEREFORE_MYTENANT_USERNAME=your.username
THEREFORE_MYTENANT_PASSWORD=your-password
THEREFORE_MYTENANT_TENANTNAME=mytenant


看 环境变量 以获取完整参考。

### 跑步```bash
# stdio (default) — for MCP clients
python3 src/mcp_server.py

# HTTP/SSE on port 8000
python3 src/mcp_server.py --http 8000

# Both simultaneously
python3 src/mcp_server.py --stdio --http 8000

HTTP模式需要 fastapi 和 uvicorn:```bash
pip install fastapi uvicorn


______________________________________________________________________

## MCP客户端配置

### 克劳德桌面/克劳德代码

添加 `~/.claude/claude_desktop_config.json` (桌面)或 `~/.claude/config.json` (代码):```json
{
"mcpServers": {
"therefore": {
"command": "python3",
"args": ["/path/to/therefore-mcp/src/mcp_server.py"],
"env": {
"THEREFORE_ENV_PATH": "/path/to/therefore-mcp/.env.local"
}
}
}
}

光标

添加 .cursor/mcp.json 在项目根目录中:```json
{
"mcpServers": {
"therefore": {
"command": "python3",
"args": ["/path/to/therefore-mcp/src/mcp_server.py"],
"env": {
"THEREFORE_ENV_PATH": "/path/to/therefore-mcp/.env.local"
}
}
}
}


### VS代码(副本)

添加 `.vscode/mcp.json` 在您的工作空间中:```json
{
"servers": {
"therefore": {
"type": "stdio",
"command": "python3",
"args": ["/path/to/therefore-mcp/src/mcp_server.py"],
"env": {
"THEREFORE_ENV_PATH": "/path/to/therefore-mcp/.env.local"
}
}
}
}

鹅(HTTP传输)

使用启动服务器 --http 8000,然后配置:```yaml

~/.config/goose/config.yaml

extensions:
therefore:
type: sse
uri: http://localhost:8000/mcp
headers:
Authorization: "Bearer your-secret-token" # if THEREFORE_MCP_AUTH_TOKEN is set


______________________________________________________________________

## 工具

工具按域分组。每个工具都需要一个强制性 `operation` string和必填项 `tenant` 弦。

|工具|操作|
|------|-----------|
| `ask_therefore_expert` |智能路由器——描述任务的正确工具和操作|
| `therefore_system` |连接信息、域信息、服务器版本、JWT/ADFS令牌交换|
| `therefore_categories` |获取信息、按名称解析、列出字段、解析字段、引用表信息和查询、生成配置XML|
| `therefore_documents` |获取、创建、更新、更新索引数据、添加流、删除、复制、签出/签入、撤消签出、获取版本/流/评论/历史/属性、添加评论|
| `therefore_query` |同步查询、异步查询、多类别查询、全文搜索、用户查询、工作流实例查询、引用表查询|
| `therefore_workflow` |获取任务、获取实例、声明、发布、完成、委派、获取历史记录、启动工作流、获取流程列表和定义|
| `therefore_users` |获取连接用户、解析、列表、创建、设置/更改密码、移动许可证、门户用户管理、获取/设置设置、删除|
| `therefore_keywords` |列出字典,获取关键字,添加/更新/删除关键字,获取关键字信息|
| `therefore_knowledge` |搜索API文档,获取工作流程指南,字段类型信息,常见模式,已知怪癖,列出资源,获取实时API帮助|

______________________________________________________________________

## 认证

每个租户支持三种身份验证方法:

### 基本身份验证(最常见)```env
THEREFORE_MYTENANT_AUTH_METHOD=Basic
THEREFORE_MYTENANT_USERNAME=your.username
THEREFORE_MYTENANT_PASSWORD=your-password

持有者令牌```env

THEREFORE_MYTENANT_AUTH_METHOD=Bearer
THEREFORE_MYTENANT_PASSWORD=your-bearer-token


### S2S——可信令牌发行者

对于其中由中央身份验证提供者管理而不是存储在env文件中的“因此”凭据的服务到服务部署:```env
THEREFORE_MYTENANT_AUTH_METHOD=S2S
THEREFORE_MYTENANT_AUTH_PROVIDER_URL=https://your-auth-provider/
THEREFORE_MYTENANT_BRIDGE_API_KEY=optional-api-key
THEREFORE_MYTENANT_USER_MAPPING=service-account-name

服务器调用 POST {AUTH_PROVIDER_URL}/issue-token 随着 {"tenant": "...", "user_hint": "..."} 并为每个租户缓存返回的JWT。看 services/auth-provider/ 作为参考实现。

ADFS / 输入 ID

使用 therefore_system → operation: get_connection_token_from_adfs 将预先获得的Entra ID令牌兑换为So JWT。需要v1 ID令牌(RS256,版本:1.0,带 upn 索赔)。看 AUTHENTICATION_README.md 对于全流量和 scripts/ 用于辅助脚本。


多租户设置

在中定义多个租户 .env.local:```env
THEREFORE_TENANTS=acme,contoso
THEREFORE_DEFAULT_TENANT=acme

THEREFORE_ACME_BASE_URL=https://acme.thereforeonline.com/theservice/v0001/restun
THEREFORE_ACME_AUTH_METHOD=Basic
THEREFORE_ACME_USERNAME=svc.account
THEREFORE_ACME_PASSWORD=secret
THEREFORE_ACME_TENANTNAME=acme

THEREFORE_CONTOSO_BASE_URL=https://contoso.thereforeonline.com/theservice/v0001/restun
THEREFORE_CONTOSO_AUTH_METHOD=Basic
THEREFORE_CONTOSO_USERNAME=svc.account
THEREFORE_CONTOSO_PASSWORD=secret
THEREFORE_CONTOSO_TENANTNAME=contoso


**租户处置令** (根据请求):

1. 明确的 `tenant` 工具调用中的参数
1. 根据参数内容(名称、提示)推断
1. 智能默认设置——如果调用者只能访问一个租户,则自动使用它
1. 粘滞--退回到上次使用的租户

### 客户端访问控制(HTTP模式)

在HTTP模式下运行时,创建 `config/clients.json` 以限制每个API密钥可以访问的租户:```json
{
"api-key-for-team-a": ["acme"],
"api-key-for-team-b": ["acme", "contoso"]
}

客户端通过以下方式进行身份验证 Authorization: Bearer。所有访问都记录在审核日志中。


码头工人```bash

stdio (default)

docker run --rm -i --env-file /path/to/.env.local fybre/therefore-mcp

HTTP on port 8000

docker run --rm -p 8000:8000 --env-file /path/to/.env.local fybre/therefore-mcp --http 8000

Build locally

docker build -t therefore-mcp .
docker run --rm -i --env-file /path/to/.env.local therefore-mcp


### Docker Compose```bash
# HTTP mode (production, detached)
docker compose --profile http up -d

# HTTP + optional S2S auth provider
docker compose --profile http --profile auth up -d

# stdio mode
docker compose --profile stdio up

创建 .env.local 在开始之前,先在项目根目录中。


环境变量

每位租户

变量 描述
THEREFORE_TENANTS 以逗号分隔的租户密钥列表
THEREFORE_DEFAULT_TENANT 配置多个租户时的默认租户
THEREFORE__BASE_URL 因此,WebAPI基础URL
THEREFORE__AUTH_METHOD Basic, Bearer,或 S2S
THEREFORE__USERNAME 用户名(基本身份验证)
THEREFORE__PASSWORD 密码或承载令牌
THEREFORE__TENANTNAME TenantName标头值(默认为URL子域)
THEREFORE__AUTH_PROVIDER_URL 令牌颁发者URL(S2S身份验证)
THEREFORE__BRIDGE_API_KEY 令牌颁发者的API密钥(S2S身份验证)
THEREFORE__USER_MAPPING S2S令牌请求的用户上下文
THEREFORE__ASSIGNEE_ALIASES 逗号分隔的工作流受让人别名
THEREFORE__USER_GROUPS 逗号分隔的用户组筛选器

服务器

变量 描述 默认值
THEREFORE_ENV_PATH 通往 .env.local 项目根
THEREFORE_MCP_AUTH_TOKEN HTTP端点的全局承载令牌 无(打开)
THEREFORE_CACHE_DIR 缓存目录 ./cache
THEREFORE_DEBUG 详细的请求/响应日志记录(1/true) 已禁用
THEREFORE_LOCAL_TZ 日期计算时区 系统默认值
THEREFORE_WORKFLOW_TIMEOUT_SECONDS 工作流调用超时 240
THEREFORE_WORKFLOW_MAX_ROWS 最大工作流查询行数 10000
THEREFORE_WORKFLOW_RETRY_TIMEOUT_SECONDS 重试等待时间 480
THEREFORE_WORKFLOW_RETRY_COUNT 重试尝试 1

建筑```

src/
mcp_server.py # MCP server — 9 grouped tools, operation registry, tenant
therefore_client.py # HTTP client — auth, retries, config building, all API methods
knowledge_tools.py # Knowledge base utilities for therefore_knowledge tool
config/
clients.json # Client API key → tenant access list (HTTP mode)
clients.json.example # Template
services/
auth-provider/ # Reference S2S token issuer implementation
tools/
config_generator/ # Delta XML generator for Therefore category creation
scripts/
validate_therefore_api.py # API connectivity validation
get_entra_token_device_code.py # Entra ID v1 device code flow
test_entra_jwt_exchange.py # Test ADFS/Entra → Therefore JWT exchange
docs/
therefore-api-complete-guide.md # Comprehensive API reference
PYTHON_EXAMPLES.md # Python code examples
PYTHON_QUICK_REFERENCE.md # Quick field type and pattern reference
knowledge-base.json # Structured API knowledge (used by therefore_knowledge tool)


### 保持知识同步

服务器的本地知识库(`docs/knowledge-base.json`)以及延长降价
文件编制(`docs/PYTHON_EXAMPLES.md`, `docs/PYTHON_QUICK_REFERENCE.md`,
`docs/therefore-api-complete-guide.md`)是两个应保持一致的独立层:

- `knowledge-base.json` --结构化JSON查询 `therefore_knowledge` 运行时的MCP工具
- Markdown文档——由引用 因此api技能 通过GitHub原始URL

当您发现新的API异常、更新工作流或更正模式时, **更新两者**:

1. 在中添加/编辑相关条目 `docs/knowledge-base.json`
1. 更新相关markdown文档中的相应部分

这 `therefore_knowledge` 搜索工具将把人工智能助手定向到GitHub文档,作为
如果本地知识库没有令人满意的答案,则回退。

### 关键设计决策

- **分组工具:** 9个域工具 `operation` 参数,而不是数百个单独的工具。降低MCP工具列表噪音,同时保持完全覆盖。
- **具有访问控制的多租户:** 每个客户端API密钥→ 每次工具调用时都强制执行租户分配。所有通话都会被审计记录。
- **模糊匹配:** 类别和字段名称已解析 `difflib.SequenceMatcher`.返回a `needs_confirmation` 当置信度低于阈值时,标记。
- **Web客户端文档流:** 文档创建遵循So web客户端使用的四步流程: `GetCategoryInfo → PreprocessIndexData → EvaluateConditionalProperties → CreateDocument`.
- **异步查询批处理:** `execute_async_single_query_all` 自动获取所有页面,并始终释放服务器会话 `finally` 块。
- **缓存:** 使用300秒TTL缓存的类别、字段和关键字元数据,持久化到 `cache/` 每个租户。

______________________________________________________________________

## 调试

集 `THEREFORE_DEBUG=1` 有关stderr的详细请求/响应日志记录:```bash
THEREFORE_DEBUG=1 python3 src/mcp_server.py

输出示例:[THEREFORE] POST https://tenant.thereforeonline.com/.../GetCategoryInfo (142 bytes) [THEREFORE] <- 200 OK (3854 bytes, 237ms) [THEREFORE] POST https://tenant.thereforeonline.com/.../ExecuteAsyncSingleQuery (285 bytes) [THEREFORE] <- 200 OK (1204 bytes, 89ms)


许可证

麻省理工学院

归因

建造于 Fybre 在以下人员的协助下 克劳德代码 (人类学)。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Therefore MCP 怎么安装?

在客户端按下面的安装命令接入:python3 src/mcp_server.py。装完在客户端配置里引用同一个包或端点。

Therefore MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Therefore MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Therefore MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Therefore MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Therefore MCP 能提供哪些能力?

资料显示约 9 个工具;能力标签包括 文档处理、多租户、Python、Claude、工作流自动化。具体工具清单以官方文档为准。

Therefore MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Therefore MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。