Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
A permissioned MCP gateway for agent proposals to a Git-backed Obsidian vault.เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ Obsidian GitHub MCP (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 5 ช่อง (VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
VAULT_MCP_GITHUB_OWNER Owner of the operator-authorised vault repository.VAULT_MCP_GITHUB_REPO Operator-authorised vault repository name.VAULT_MCP_POLICY_FILE Absolute path to the operator-provisioned policy YAML.VAULT_MCP_TOKEN_FILE Absolute path to the operator-provisioned client-token YAML.GITHUB_APP_INSTALLATION_ID GitHub App installation ID, required with GITHUB_APP_ID.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
SettingsDeveloperEdit Config
{
"mcpServers": {
"obsidian-github": {
"command": "npx",
"args": [
"-y",
"@sarutobi-sasuke/obsidian-github-mcp"
],
"env": {
"VAULT_MCP_GITHUB_OWNER": "ใส่ค่าของคุณ",
"VAULT_MCP_GITHUB_REPO": "ใส่ค่าของคุณ",
"VAULT_MCP_POLICY_FILE": "ใส่ค่าของคุณ",
"VAULT_MCP_TOKEN_FILE": "ใส่ค่าของคุณ",
"GITHUB_TOKEN": "ใส่ค่าของคุณ",
"GITHUB_APP_INSTALLATION_ID": "ใส่ค่าของคุณ",
"GITHUB_APP_PRIVATE_KEY_FILE": "ใส่ค่าของคุณ"
}
}
}
}วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ใช้ Obsidian GitHub MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ Obsidian GitHub MCP หรือมีชื่อเครื่องมือของ Obsidian GitHub MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
VAULT_MCP_PORT Loopback HTTP listening port. · ค่าเริ่มต้น 3210GITHUB_APP_ID GitHub App alternative: set all three App variables instead of GITHUB_TOKEN.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ChatGPT ยังต่อ Obsidian GitHub MCP ไม่ได้
Obsidian GitHub MCP ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ
ก · ใช้แอปที่ต่อ Obsidian GitHub MCP ได้
ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ Obsidian GitHub MCP (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 5 ช่อง (VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
VAULT_MCP_GITHUB_OWNER Owner of the operator-authorised vault repository.VAULT_MCP_GITHUB_REPO Operator-authorised vault repository name.VAULT_MCP_POLICY_FILE Absolute path to the operator-provisioned policy YAML.VAULT_MCP_TOKEN_FILE Absolute path to the operator-provisioned client-token YAML.GITHUB_APP_INSTALLATION_ID GitHub App installation ID, required with GITHUB_APP_ID.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --scope user obsidian-github --env VAULT_MCP_GITHUB_OWNER='ใส่ค่าของคุณ' --env VAULT_MCP_GITHUB_REPO='ใส่ค่าของคุณ' --env VAULT_MCP_POLICY_FILE='ใส่ค่าของคุณ' --env VAULT_MCP_TOKEN_FILE='ใส่ค่าของคุณ' --env GITHUB_TOKEN='ใส่ค่าของคุณ' --env GITHUB_APP_INSTALLATION_ID='ใส่ค่าของคุณ' --env GITHUB_APP_PRIVATE_KEY_FILE='ใส่ค่าของคุณ' -- npx -y @sarutobi-sasuke/obsidian-github-mcpแก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ต้องเห็น Obsidian GitHub MCP ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ Obsidian GitHub MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ Obsidian GitHub MCP หรือมีชื่อเครื่องมือของ Obsidian GitHub MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
VAULT_MCP_PORT Loopback HTTP listening port. · ค่าเริ่มต้น 3210GITHUB_APP_ID GitHub App alternative: set all three App variables instead of GITHUB_TOKEN.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ Obsidian GitHub MCP (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 5 ช่อง (VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
VAULT_MCP_GITHUB_OWNER Owner of the operator-authorised vault repository.VAULT_MCP_GITHUB_REPO Operator-authorised vault repository name.VAULT_MCP_POLICY_FILE Absolute path to the operator-provisioned policy YAML.VAULT_MCP_TOKEN_FILE Absolute path to the operator-provisioned client-token YAML.GITHUB_APP_INSTALLATION_ID GitHub App installation ID, required with GITHUB_APP_ID.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ในค่าตั้งของ Obsidian GitHub MCP ช่อง GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE, VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ใช้ Obsidian GitHub MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ Obsidian GitHub MCP หรือมีชื่อเครื่องมือของ Obsidian GitHub MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
VAULT_MCP_PORT Loopback HTTP listening port. · ค่าเริ่มต้น 3210GITHUB_APP_ID GitHub App alternative: set all three App variables instead of GITHUB_TOKEN.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ Obsidian GitHub MCP (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 5 ช่อง (VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
VAULT_MCP_GITHUB_OWNER Owner of the operator-authorised vault repository.VAULT_MCP_GITHUB_REPO Operator-authorised vault repository name.VAULT_MCP_POLICY_FILE Absolute path to the operator-provisioned policy YAML.VAULT_MCP_TOKEN_FILE Absolute path to the operator-provisioned client-token YAML.GITHUB_APP_INSTALLATION_ID GitHub App installation ID, required with GITHUB_APP_ID.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ในค่าตั้งของ Obsidian GitHub MCP ช่อง GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE, VAULT_MCP_GITHUB_OWNER, VAULT_MCP_GITHUB_REPO, VAULT_MCP_POLICY_FILE, VAULT_MCP_TOKEN_FILE, GITHUB_APP_INSTALLATION_ID ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ใช้ Obsidian GitHub MCP บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ Obsidian GitHub MCP หรือมีชื่อเครื่องมือของ Obsidian GitHub MCP ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
VAULT_MCP_PORT Loopback HTTP listening port. · ค่าเริ่มต้น 3210GITHUB_APP_ID GitHub App alternative: set all three App variables instead of GITHUB_TOKEN.คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
Claude Code
claude mcp add --scope user obsidian-github --env VAULT_MCP_GITHUB_OWNER='ใส่ค่าของคุณ' --env VAULT_MCP_GITHUB_REPO='ใส่ค่าของคุณ' --env VAULT_MCP_POLICY_FILE='ใส่ค่าของคุณ' --env VAULT_MCP_TOKEN_FILE='ใส่ค่าของคุณ' --env GITHUB_TOKEN='ใส่ค่าของคุณ' --env GITHUB_APP_INSTALLATION_ID='ใส่ค่าของคุณ' --env GITHUB_APP_PRIVATE_KEY_FILE='ใส่ค่าของคุณ' -- npx -y @sarutobi-sasuke/obsidian-github-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"obsidian-github": {
"command": "npx",
"args": [
"-y",
"@sarutobi-sasuke/obsidian-github-mcp"
],
"env": {
"VAULT_MCP_GITHUB_OWNER": "ใส่ค่าของคุณ",
"VAULT_MCP_GITHUB_REPO": "ใส่ค่าของคุณ",
"VAULT_MCP_POLICY_FILE": "ใส่ค่าของคุณ",
"VAULT_MCP_TOKEN_FILE": "ใส่ค่าของคุณ",
"GITHUB_TOKEN": "ใส่ค่าของคุณ",
"GITHUB_APP_INSTALLATION_ID": "ใส่ค่าของคุณ",
"GITHUB_APP_PRIVATE_KEY_FILE": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"obsidian-github": {
"command": "npx",
"args": [
"-y",
"@sarutobi-sasuke/obsidian-github-mcp"
],
"env": {
"VAULT_MCP_GITHUB_OWNER": "ใส่ค่าของคุณ",
"VAULT_MCP_GITHUB_REPO": "ใส่ค่าของคุณ",
"VAULT_MCP_POLICY_FILE": "ใส่ค่าของคุณ",
"VAULT_MCP_TOKEN_FILE": "ใส่ค่าของคุณ",
"GITHUB_TOKEN": "ใส่ค่าของคุณ",
"GITHUB_APP_INSTALLATION_ID": "ใส่ค่าของคุณ",
"GITHUB_APP_PRIVATE_KEY_FILE": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"obsidian-github": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sarutobi-sasuke/obsidian-github-mcp"
],
"env": {
"VAULT_MCP_GITHUB_OWNER": "ใส่ค่าของคุณ",
"VAULT_MCP_GITHUB_REPO": "ใส่ค่าของคุณ",
"VAULT_MCP_POLICY_FILE": "ใส่ค่าของคุณ",
"VAULT_MCP_TOKEN_FILE": "ใส่ค่าของคุณ",
"GITHUB_TOKEN": "ใส่ค่าของคุณ",
"GITHUB_APP_INSTALLATION_ID": "ใส่ค่าของคุณ",
"GITHUB_APP_PRIVATE_KEY_FILE": "ใส่ค่าของคุณ"
}
}
}
}VAULT_MCP_PORT envVAULT_MCP_GITHUB_OWNER จำเป็น envVAULT_MCP_GITHUB_REPO จำเป็น envVAULT_MCP_POLICY_FILE จำเป็น envVAULT_MCP_TOKEN_FILE จำเป็น envGITHUB_TOKEN ความลับ จำเป็น envGITHUB_APP_ID envGITHUB_APP_INSTALLATION_ID จำเป็น envGITHUB_APP_PRIVATE_KEY_FILE ความลับ จำเป็น envคำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
npm: @sarutobi-sasuke/obsidian-github-mcpดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 14 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub SarutobiSasuke8 ซึ่งเป็นเจ้าของ repo
มีการแก้โค้ดล่าสุด วันนี้
ใช้ Apache-2.0
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: GITHUB_TOKEN, GITHUB_APP_PRIVATE_KEY_FILE
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
repo บน GitHub มีการแก้โค้ดล่าสุด วันนี้ และส่งรุ่นล่าสุด (0.1.0) เข้า registry 20 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, XcodeBuildMCP
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
A white-label Model Context Protocol server that gives selected AI agents bounded, auditable access to propose changes to an Obsidian vault stored in GitHub.
Each agent receives its own expiring MCP bearer token. The GitHub credential remains server-side. Read and write paths, denials, protected surfaces, proposal branches, and token revocation are controlled by operator-owned YAML files.
This is an independent open-source project. It is not affiliated with or endorsed by Obsidian or GitHub.
Giving an agent a general GitHub token is difficult to constrain and easy to misuse. This server creates a narrower boundary:
AI agent + individual MCP token
| v identity + fixed broker | v agent write scope AND broker publication scope | v deny, path, frontmatter, mutability, size, and secret checks | v server-side GitHub App token | v proposal branch for human review
The service has no tools for deleting files, merging branches, pushing to main or master, changing repository settings, editing workflows, or exposing credentials.
living, review-first, append-only, and immutable note handling| Tool | Purpose |
|---|---|
vault_whoami | Show the authenticated identity, broker, branch, and policy scopes. |
vault_list_allowed_paths | Explain effective read/write/deny boundaries. |
vault_explain_access | Dry run a single path. Report whether read, list, or write would be permitted and which policy rule decides it. No GitHub call. |
vault_list_files | List an authorised directory while filtering denied children. |
vault_read_file | Read an authorised UTF-8 vault file. |
vault_create_file | Create a file on the identity's fixed proposal branch. |
vault_update_file | Update a permitted file while respecting mutability. |
vault_append_file | Append while preserving all existing bytes. |
Contents: read and write, or a fine-grained PAT for local testingInstall from source (the current supported path):
git clone https://github.com/YOUR_ACCOUNT/obsidian-github-mcp.git
cd obsidian-github-mcp npm ci cp .env.example .env cp config/policy.example.yaml config/policy.yaml cp config/tokens.example.yaml config/tokens.yaml npm run token:new npm run check
npm start
Configure .env (specifying your repository and either a GITHUB_TOKEN or GitHub App credentials), replace the sample policy, and put only the generated token's SHA-256 in config/tokens.yaml. Give the raw bearer token to exactly one MCP client.
To verify a checkout before configuring a running service:
npm ci
npm run check npm run test:e2e
These checks use synthetic notes, mock GitHub responses and loopback transports. They need no GitHub or MCP credentials. Note regressions cover Unicode/path encoding, CRLF frontmatter, malformed metadata, UTF-8 size limits and append-only byte preservation. CI runs the same checks on Linux and Windows with Node.js 22 and 24. The 8 tools listed above are the current server surface; tests do not publish proposals to a real vault.
Once v0.1.0 is published to npm, a global install will also be available:
# Available once v0.1.0 is published (not yet on the npm registry).
npm install -g @sarutobi-sasuke/obsidian-github-mcp
The default endpoints are:
GET http://127.0.0.1:3210/healthz
POST http://127.0.0.1:3210/mcp
MCP clients must send:
Authorization: Bearer vault_<generated-token>
The effective write scope is the intersection of the agent grant and its broker:
policy_version: 1
authority: operator-only
agents:
git_brokers:
never_versioned: [Private/, People/, .obsidian/, secrets/]
surface_rules:
An auth binding then maps one token hash to that identity and broker. The binding cannot grant paths that the policy does not grant.
See Permissions documentation for provisioning and revocation.
Production deployments should use a GitHub App installed only on the vault repository. Configure:
GITHUB_APP_ID=123456
GITHUB_APP_INSTALLATION_ID=12345678 GITHUB_APP_PRIVATE_KEY_FILE=/run/secrets/vault-mcp.pem
The server creates short-lived installation tokens restricted again to the configured repository and contents: write. A repository-scoped GITHUB_TOKEN is supported as a local-development fallback.
The included container runs as a non-root user with a read-only root filesystem. Put TLS, a private overlay network, or an authenticated gateway in front of the service before making it remotely reachable.
See Deployment guide.
npm run check
npm audit --audit-level=high
Tests cover policy parsing, write-scope intersection, deny precedence, traversal attempts, frontmatter rules, mutability, secret detection, token bindings, and fixed-branch GitHub writes.
Run npm run test:e2e for a clean tarball installation and real MCP HTTP client proof against a test-only GitHub substitute. It exercises proposal writes, denied paths/content, immutable and append-only notes, stale-write conflicts, invalid policy reloads, live token revocation and content-free audit records. CI runs this proof on Windows/Linux with Node 22/24, and the release workflow requires it.
Policy and token files reject unknown keys. Only policy_version: 1 and authority: operator-only are supported. Correct misspelt fields or remove unsupported metadata before upgrading; silently ignored restrictions are no longer accepted. Release evidence and remaining gates.
The draft MCP Registry npm entry describes a self-hosted Streamable HTTP process, not a stdio server. A compatible client starts the process with the declared environment and connects to http://127.0.0.1:{VAULT_MCP_PORT}/mcp (port 3210 by default). Supply the existing policy and token-file paths plus the repository owner/name. For GitHub access, use either GITHUB_TOKEN or all three documented GitHub App variables. The manifest cannot express that alternative group; runtime configuration validates it. The process does not create credentials, provision a hosted endpoint or bypass its existing bearer-token checks. The namespace preserves the exact GitHub owner spelling. prepublishOnly includes the registry/package gate; no login or publication is performed by it.
Read Security policy before deployment. Report suspected vulnerabilities privately rather than opening a public issue with exploit details.
Apache-2.0. See Apache-2.0 License.