1MCP

1MCP birleştirilmiş MCP çalışma zamanıdır. 1mcp serve MCP sunucularınızı bir araya getirir ve CLI modu, Codex, Claude, Cursor ve benzeri araç kullanan ajanlar için daha ince bir ajan yönelik iş akışı ekler.

Neden 1MCP

Çoğu MCP kurulumu sonunda iki tür yayılımla karşılaşır:

• Konfigürasyon yayılımı: her istemci kendi MCP kablolama, kimlik doğrulama seçimleri ve filtreleme kurallarına ihtiyaç duyar.
• Ajan yayılımı: otonom oturumlar bağlamın başından çok sayıda araç ve şema taşır.

1MCP her ikisini de çözer:

• 1mcp serve birçok MCP sunucusunun önünde bir birleştirilmiş çalışma zamanı sağlar.
• CLI modu ajanların instructions, inspect ve run ile araçları kademeli olarak keşfetmesine izin verir.
• Statik sunucular başlangıçta yüklenebilir, şablon sunucuları ise istemci veya oturum bağlamından oluşturulur.
• Ön ayarlar, filtreler ve talimat toplaması aynı çalışma zamanını istemciler ve projeler arasında uyarlanabilir tutar.

Yaklaşım	En iyisi	Ödün
1MCP CLI modu	Codex, Claude, ajan döngüleri	Çalışan 1mcp serve örneği gerektirir
1MCP stdio proxy	İstemciler arasında maksimum uyumluluk	Hala serve bağımlı, kimlik doğrulama yapabilen HTTP istemcilerinin daha doğrudan yolu var
Doğrudan streamable HTTP	MCP-native HTTP istemcileri	Proje bağlamı yok, .1mcprc yok ve daha geniş araç yüzeyi doğrudan açığa çıkar
Özel proxy	Bir kerelik uyumluluk shimler	Keşfi, filtrelemeyi, kimlik doğrulamayı ve çalışma zamanı yaşam döngüsünü siz yönetirsiniz

Ajan Kullanıcıları İçin Hızlı Başlangıç

Bu sayfa AI ajan kullanıcıları için optimize edilmiştir. 5 dakikalık sonuç basittir: gerçek bir 1mcp serve çalışma zamanı başlatın, ajanınızı cli-setup ile bağlayın ve ardından instructions -> inspect -> run iş akışını doğrulayın.

1MCP yükleyin, bir upstream sunucu ekleyin ve çalışma zamanını başlatın:

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

İkinci bir shell'de ajanınızı CLI moduna bağlayın:

1mcp cli-setup --codex
# veya
1mcp cli-setup --claude --scope repo --repo-root .

Ardından ajan iş akışını doğrulayın:

# shell 1
1mcp serve

# shell 2
1mcp instructions
1mcp inspect context7
1mcp inspect context7/query-docs
1mcp run context7/query-docs --args '{"libraryId":"/mongodb/docs","query":"aggregation pipeline"}'

Tam açıklamayı istiyorsanız (başarı kriterleri ve çıkış yolları ile), Hızlı Başlangıç kılavuzunu kullanın.

Belirli bir ajan için yalnızca bir modu seçin. Eğer bu ajanı CLI moduna geçirirseniz, önce eski doğrudan MCP yapılandırmasını kaldırın.

CLI Modu Neden Var

CLI modu, ajan tarzı oturumlar için birincil iş akışıdır. MCP'yi backend protokolü olarak tutar ancak ajanın her adımda gördüğü şeyi daraltır:

• instructions güncel çalışma zamanını ve önerilen akışı açıklar
• inspect ajanın yalnızca ihtiyacı olan sunucuyu veya aracı keşfetmesine izin verir
• run şema incelemesinden sonra seçilen bir aracı yürütür

Bu, ajan döngülerine 1mcp serve arkasındaki birleştirilmiş çalışma zamanını kaybetmeden daha küçük bir çalışma yüzeyi verir.

Başka Bir Yol Seçin

Stdio Proxy

Proje bağlamını kaybetmeden en geniş istemci uyumluluğunu istediğinizde 1mcp proxy kullanın.

CLI modundan sonra önerilen geri dönüş çünkü:

• çoğu AI istemcisinin zaten desteklediği stdio taşımasını destekler
• .1mcprc aracılığıyla proje bağlamını tutar
• proje veya oturum bağlamından çözülen şablon MCP sunucularını destekler
• bir kerelik global kurulum artı proje başına yapılandırma ile dağıtımı daha kolaylaştırır

Doğrudan stdio modu önerilen yol değildir. Birincil olarak hata ayıklama için yararlıdır çünkü 1MCP başlangıcı, ince bağımsız stdio kurulumundan daha yavaştır.

Doğrudan MCP Eki

Doğrudan MCP eki hala, birleştirilmiş çalışma zamanıyla streamable HTTP üzerinden konuşmak isteyen istemciler için desteklenir.

Örnekler:

{
  "mcpServers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=cursor"
    }
  }
}

claude mcp add -t http 1mcp "http://127.0.0.1:3050/mcp?app=claude-code"

İstemciniz MCP'yi doğal olarak konuşuyorsa, proje bağlamı olmadan çalışabiliyorsa ve CLI modunu istemiyorsanız bu yolu kullanın. Codex, Claude, Cursor ve benzeri ajan döngüleri için CLI modunu birinci, proxy tercihini ikinci olarak tercih edin.

Çalışma Zamanı Operatörleri

Çalışma zamanının kendisini yapılandırıyorsanız veya dağıtıyorsanız daha derin dokümentasyonu kullanın:

• Konfigürasyon
• Kimlik Doğrulama
• Mimari

Katkıda Bulunanlar

• Geliştirme kılavuzu
• CONTRIBUTING.md

Nasıl Çalışır

flowchart LR
    A[User or Agent] --> B[1mcp serve]
    B --> C[Static servers loaded at startup]
    B --> D[Template servers resolved from client or session context]
    A --> E[CLI mode: instructions -> inspect -> run]
    E --> B
    F[Direct streamable HTTP client] --> B
    G[stdio-compatible client] --> H[1mcp proxy]
    H --> B

1MCP 1mcp serve arkasında birleştirilmiş bir çalışma zamanı olarak çalışır. Statik sunucular başlangıç yapılandırmasından hazırlanır, şablon sunucuları istemci bağlamı bilindiğinde somutlaştırılır ve çalışma zamanı başlangıç engellenmesini ve araç yüzeyi gürültüsünü azaltmak için async yüklemeyi ve lazy yüklemeyi kullanabilir. Talimat toplaması, ön ayarlar ve bildirimler bu çalışma zamanının yanında bulunur.

Temel Özellikler

• Bir serve işleminin arkasında birçok MCP sunucusu için birleştirilmiş çalışma zamanı
• 1mcp instructions, 1mcp inspect <server>, 1mcp inspect <server>/<tool> ve 1mcp run <server>/<tool> --args '<json>' ile kademeli keşif için CLI modu
• İstemci veya oturum başına çözüm için şablon sunucuları
• Daha hızlı başlangıç ve daha dar maruz kalış için async yükleme ve lazy yükleme
• Statik ve şablon destekli sunucular arasında talimat toplaması
• Ön ayarlar, filtreler ve ön ayar değişikliği bildirimleri
• Proje bağlamı ve şablon sunucu desteği ile maksimum uyumluluk için proxy
• Proje bağlamına ihtiyaç duymayan yerel HTTP istemcileri için doğrudan streamable HTTP MCP erişimi

Yaygın Kullanım Durumları

• Kodlama ajanına bir kararlı çalışma zamanı verin ancak daha küçük bir çalışma yüzeyi sağlayın.
• Aynı MCP envanterini Cursor, Claude Code, Codex ve dahili araçlar arasında paylaşın.
• Depo, dal veya oturum başına bağlama özgü şablon sunucuları ortaya koymak.
• Kimlik doğrulama, filtreleme, ön ayarlar ve çalışma zamanı yaşam döngüsünü merkezi olarak gerçekleştirin, bunları geçici komut dosyalarda yeniden oluşturmak yerine.

Katkı / Lisans

Katkılar hoş karşılanır. Geliştirme iş akışı için CONTRIBUTING.md ve Apache 2.0 lisansı için LICENSE bölümüne bakın.