Ateliers AI Mcpserver

Ateliers AI MCP服务器

C#/.NET中所述的工具，调整墙的布局和几何形状Model Context Protocol（MCP）服务器。 多个IDE和AI从客户端GitHub/本地文件集成操作和技术记事参照提供。

______________________________________________________________________

⚠️ 关于贝塔版

本项目是正在开发中的贝塔版。

• ✅ 基本功能已实现
• ❌ 不能保证动作的稳定性
• ⚠️ 因为是个人项目，所以支持是有限的
• 🔧 可能发生规格变更或破坏性变更，恕不另行通知

请自己负责使用。\ 不建议在生产环境或重要数据中使用。

问题报告和改善提案问题拜托了。

______________________________________________________________________

概要

ateliers.dev的技术资产（编码准则、技术文章、开发资料档案库）IDE的明细栏样式中定义的设置MCP服务器。

主要特征

• ✅ 多客户端支持 - Claude Desktop、VS Code、Visual Studio的规格化距离的幂函数
• ✅ 本地优先访问 - LocalPath设定时高速的本地文件操作，未设定时GitHub API经由
• ✅ Git统合 - AutoPull/AutoPush支持，自动提交和推送文件更改
• ✅ 通用文件操作 -完整的读/写/删除/重命名/复制/备份CRUD
• ✅ 文章专门工具 - ateliers.dev技术记事の検索・一覧・読み取り（Frontmatter自动除去）
• ✅ 支持多个存储库 -配置文件中灵活的存储库管理

支持的客户端

｜客户端｜版本｜状态｜ |:--|:--|:--| | Claude Desktop | 最新版✅ 完全支持 | VS Code | 1.102+ | ✅ Agent Mode対応 | | Visual Studio | 2022 17.14+ / 2026 Preview | ✅ Agent Mode対応 |

版本历史记录

v0.7.0（2024-12-02）

• 第7阶段: Notion基础统合
• Notion API接続基盤実装
• Tasks管理工具实施（CRUD操作）
• Ideas管理工具实施（CRUD操作）

v0.6.0（2024-11-29）

• Phase 6完了：多客户端集成
• VS Code集成（代理模式，支持相对路径）
• Visual Studio集成（代理模式，增强安全性）
• Claude Desktop统合确认
• 为每个客户端创建安装指南
• .vscode/mcp.json.sample 和 .mcp.json.sample 提供

v0.5.0（2024-11-28）

• Phase 5完了: Git操作统合
• LibGit2Sharp导入
• GitOperationService実装（拉、提交、推、提交和推）
• AutoPull/AutoPush机能実装
• 身份验证信息分层（存储库特定-全局）
• 冲突检测和错误处理
• 六个写入工具Git整合

v0.4.0（2024-11-26）

• Phase 4完了：本地文件优先逻辑实现
• 本地文件服务新設（完全CRUD+重命名+复制+备份）
• RepositoryTools实现（8个通用文件操作工具）
• AteliersDevTools改善（记事検索・一覧・読み取り）
• 无需工具删除和工具说明全面改善（符合MCP工具选择指南）
• appsettings.json设计（以Dictionary格式管理存储库）

v0.3.0（以前）

• Training基于版本
• GitHub读取功能
• 基本缓存

支持的存储库

支持以下存储库（在appsettings.json中设置）：

｜存储库密钥｜说明｜用途｜ |:--|:--|:--| | AteliersAiAssistants | 编码准则AI面向编码规章·样本 | AteliersAiMcpServer | 本MCP服务器｜源代码管理｜ | AteliersDev | 技术博客Docusaurus文章·博客投稿 | PublicNotes | 公用便笺TODO索引片段 | TrainingMcpServer | Training版本MCP服务器｜学习代码库｜

机能一覧

GitTools（Git操作）

工具｜功能｜ |:--|:--| | commit_repository 提交存储库更改 | push_repository 将提交推送到远程 | pull_repository 从远程获取最新信息 | commit_and_push_repository 批量执行提交和推送 | create_tag | Git创建标记 | push_tag 将标记推送到远程位置 | create_and_push_tag 批量执行标记创建和推送

RepositoryTools（通用文件操作+Git集成

工具｜功能｜Git集成 |:--|:--|:--| | read_repository_file 文件读取 | list_repository_files 获取文件列表 | add_repository_file 新建文件AutoPull/AutoPush | | edit_repository_file 文件更新（自动备份）AutoPull/AutoPush | | delete_repository_file 文件删除（自动备份）AutoPull/AutoPush | | rename_repository_file 文件重命名AutoPull/AutoPush | | copy_repository_file 文件复制AutoPull/AutoPush | | backup_repository_file 备份创建

AteliersDevTools（记事专门）

工具｜功能｜ |:--|:--| | read_article ｜文章读取（自自动删除）｜ | list_articles |记事一覧取得（.md + .mdx）| | search_articles ｜关键字检索（文件名、内容）｜

前提条件

• .NET 8.0 SDK以降
• Git（AutoPull/AutoPush使用时）
• GitHub Personal Access Token（可选：GitHub API/Git Push使用时）
• 以下客户端之一：

- Claude Desktop（最新版） - VS Code（1.102以降）+GitHub Copilot扩张机能 - Visual Studio 2022（17.14以后）或2026Preview + GitHub Copilot

快速启动

1.克隆存储库

git clone https://github.com/yuu-git/ateliers-ai-mcpserver.git
cd ateliers-ai-mcpserver

2.创建配置文件（可选）

基本动作不需要本地设定，但是本地文件访问和Git使用集成 appsettings.local.json 中所述修改相应参数的值。

有关详细信息，请参阅每个客户端的设置指南。

3.按客户机设置

请参阅以下指南，具体取决于您使用的客户端：

克劳德桌面版

• 📖 Claude Desktop安装指南
• 需要设置完整路径
• dotnet run方式或已构建exe方式

VS Code

• 📖 VS Code安装指南
• .vscode/mcp.json.sample 复制并使用
• 支持相对路径
• Agent Mode必须

Visual Studio

• 📖 Visual Studio安装指南
• .mcp.json.sample 复制并使用
• 支持相对路径
• Agent Mode推奨

用法

文件读取

Services/GitHubService.cs を読んで

AI自动 read_repository_file 工具。

文件编辑（Git集成）

README.mdのバージョン履歴を更新して

AutoPush=true 在工作空间的边缘AI执行以下操作：

1. AutoPull确认-获取远程更新
2. read_repository_file 的README.md读取
3. 更新内容
4. edit_repository_file 保存（自动备份）
5. Git提交和推送（自动）

记事検索

GitHub Actionsに関する記事を探して

AI的 search_articles 中查找文章，并提供相关文章。

多客户端示例

1. Claude Desktopで設計・仕様検討
2. VS Codeで実装
3. Visual StudioでデバッグとCodeLens活用
   ↓
すべてのクライアントから同じMCPツールを使用

高级设置

本地文件访问

单击功能区上的appsettings.local.json 创建：

{
  "Repositories": {
    "PublicNotes": {
      "LocalPath": "[YOUR_CLONE_PATH]\\ateliers-public-notes",
      "AutoPull": true,
      "AutoPush": true
    }
  }
}

优点：

• 文件访问速度提高10-5000倍
• GitHub API避免汇率限制
• 实时编辑反馈

Git统合（AutoPull/AutoPush）

设置认证信息Git自动化操作：

{
  "GitHub": {
    "Token": "github_pat_11AAAAAA...",
    "Email": "your-email@example.com",
    "Username": "your-github-username"
  },
  "Repositories": {
    "PublicNotes": {
      "AutoPull": true,
      "AutoPush": true
    }
  }
}

故障排除

常见问题

• 📖 故障排除指南

客户端问题

每个客户端的安装指南中都有故障排除部分：

• Claude Desktop 故障排除
• VS Code 故障排除
• Visual Studio 故障排除

开発

项目结构

Ateliers.Ai.McpServer/
├─ Configuration/
│  └─ AppSettings.cs          # 設定クラス
├─ Services/
│  ├─ GitHubService.cs        # GitHub API操作
│  ├─ LocalFileService.cs     # ローカルファイル操作
│  └─ GitOperationService.cs  # Git操作（Pull/Commit/Push）
├─ Tools/
│  ├─ GitTools.cs             # Git操作ツール（Phase 5）
│  ├─ RepositoryTools.cs      # 汎用ファイル操作ツール（Git統合）
│  └─ AteliersDevTools.cs     # 記事専門ツール
├─ Program.cs                 # エントリーポイント
├─ appsettings.json           # 基本設定
└─ appsettings.local.json     # ローカル設定（Git管理外）

构建（开发模式）

dotnet build
dotnet run --project Ateliers.Ai.McpServer

测试

dotnet test

文档

安装指南

• 克劳德桌面版
• VS Code
• Visual Studio

Phase計画

• Phase 5: Git统合
• Phase 6: 多客户端集成
• Phase 7: Notion基础统合（計画中）
• Phase 8: Notion扩张（計画中）
• Phase 9: Docusaurus统合（計画中）

许可证

MIT许可证

相关链接

• 工作室开发 -技术博客
• 工作室助理 - AI编码准则
• 模型上下文协议 - MCP官方网站

今后的计划

Phase 7: Notion基础统合（次）

• Notion API接続基盘
• Tasks管理（CRUD操作）
• Ideas管理（CRUD操作）
• 作为“思考的缓冲”Notion利用率

Phase 8: Notion扩张

• Bookmarks管理（稍后再读）
• 検索机能强化
• 标签类别管理

Phase 9: Docusaurus统合

• 文章制作工具（create_blog_post，create_doc_article）
• Notion→Docusaurus转换流程
• Frontmatter自动生成
• 会话→记事变换机能
• v1.0.0目标：完整的知识管理系统

Phase 10以降

• SQLServer/SQLite统合
• 按角色MCP服务器分区（coding，docs，productivity）
• VoicePeak CLI统合
• Docker化（分发选项）