使用说明

TinaCMS MCP服务器（C#）

该项目使用官方C#SDK实现了一个独立的模型上下文协议（MCP）服务器(modelcontextprotocol/csharp-sdk).其目的是公开允许与TinaCMS项目存储库管理的内容文件进行交互的工具。

这使得AI模型或其他MCP客户端能够通过标准化的MCP在TinaCMS站点内列出、读取、创建、更新和删除内容文件。

克隆/下载： 获取此项目的源代码。
配置根路径：
- 打开 appsettings.json 文件。
- 找到 TinaProject 部分。
- 重要： 更换 样本路径 规定用于 RootPath 随着 完整、绝对路径 您的目标TinaCMS项目的根目录（包含 .tina 文件夹）。
- 使用正斜杠(/)用于路径分隔符（建议用于跨平台兼容性）或双反斜杠(\\)如果在Windows上更喜欢。
```
{
  "Logging": { ... },
  "TinaProject": {
    "RootPath": "/path/to/your/tina-project" 
  }
}
```
还原依赖关系： 打开终端 TinaMcpServer 项目目录并运行：
```
dotnet restore
```

构建： 要编译项目，请执行以下操作：
```
dotnet build
```
本地运行（用于测试）： 服务器设计为由MCP客户端（如检查器）运行。直接运行它不是很有用，但你可以从以下步骤开始：
```
dotnet run 
```
或者通过运行编译后的DLL：
```
dotnet bin/Debug/net8.0/TinaMcpServer.dll
```
服务器将启动并等待MCP客户端通过标准输入/输出连接。如果在没有客户端的情况下运行，它可能会立即退出或显示JSON错误。

测试服务器及其工具的推荐方法是使用官方的MCP检查器。

确保项目建成： 跑 dotnet build 如果你还没有。
运行检查器： 在您的终端（在 TinaMcpServer 项目目录），运行以下命令。这告诉检查器使用 dotnet:
```
npx @modelcontextprotocol/inspector dotnet bin/Debug/net8.0/TinaMcpServer.dll
```
打开检查器UI： 该命令将输出URL（例如。， http://127.0.0.1:6274).在您的网络浏览器中打开此URL。
连接： 点击检测到的“连接”按钮 TinaMcpServer.
使用工具：
- 导航到“工具”选项卡。
- 单击“列出工具”查看所有可用工具。
- 单击特定工具查看其描述和参数。
- 填写所需参数，然后单击“运行工具”。
- 观察结果，并检查运行检查器的终端是否有来自C#服务器的日志。

（此处省略了描述；有关完整详细信息，请参阅代码中的工具属性）

ListTinaCollections()：列出下的集合目录 /content.
ListCollectionDocuments(collection)：直接列出集合目录中的文件。
ListDocumentsRecursive(collection)：列出集合中的所有文件，包括子目录。
GetTinaDocument(collection, relativePath)：获取文档的全文内容。
CreateTinaDocument(collection, relativePath, content)：创建新文档；如果存在，则失败。
UpdateTinaDocument(collection, relativePath, content)：覆盖现有文件；如果它不存在，就会失败。
DeleteTinaDocument(collection, relativePath)：删除现有文档；如果它不存在，就会失败。
MoveDocument(collection, oldRelativePath, newRelativePath)：移动/重命名文档。
CopyDocument(collection, sourceRelativePath, destinationRelativePath)：复制文档。
GetDocumentMetadata(collection, relativePath)：获取YAML frontmatter作为JSON字符串。
UpdateDocumentMetadata(collection, relativePath, metadataUpdatesJson)：从JSON对象添加/更新frontmatter字段。
GetCollectionSchemaInfo(collection)：阅读 .tina/schema.json 文件内容。