Türkçe sürüm README'si burada

LINE Bot MCP Server

Model Context Protocol (MCP) sunucu uygulaması, LINE Messaging API'sini entegre ederek bir AI Ajanını LINE Resmi Hesabına bağlar.

[!NOTE] Bu depo önizleme sürümü olarak sağlanmaktadır. Deneysel amaçlar için sunulsa da, lütfen tam işlevsellik veya kapsamlı destek içermeyebileceğinin farkında olun.

Araçlar

1. push_text_message

   • LINE üzerinden bir kullanıcıya basit bir metin mesajı gönderin.
   • Girdiler:
     • userId (string?): Mesaj alacak kullanıcı ID'si. Varsayılan olarak DESTINATION_USER_ID'dir. userId veya DESTINATION_USER_ID ayarlanmalıdır.
     • message.text (string): Kullanıcıya gönderilecek düz metin içeriği.

2. push_flex_message

   • LINE üzerinden bir kullanıcıya yüksek oranda özelleştirilebilir bir flex mesajı gönderin.
   • Girdiler:
     • userId (string?): Mesaj alacak kullanıcı ID'si. Varsayılan olarak DESTINATION_USER_ID'dir. userId veya DESTINATION_USER_ID ayarlanmalıdır.
     • message.altText (string): Flex mesajı görüntülenemediğinde gösterilen alternatif metin.
     • message.contents (any): Flex mesajının içeriği. Bu, mesajın düzenini ve bileşenlerini tanımlayan bir JSON nesnesidir.
     • message.contents.type (enum): Konteyner türü. Tek konteyner için 'bubble', birden fazla kaydırılabilir bubble için 'carousel'.

3. broadcast_text_message

   • LINE üzerinden LINE Resmi Hesabınızı takip eden tüm kullanıcılara basit bir metin mesajı yayınlayın.
   • Girdiler:
     • message.text (string): Kullanıcılara gönderilecek düz metin içeriği.

4. broadcast_flex_message

   • LINE üzerinden LINE Resmi Hesabınızı ekleyen tüm kullanıcılara yüksek oranda özelleştirilebilir bir flex mesajı yayınlayın.
   • Girdiler:
     • message.altText (string): Flex mesajı görüntülenemediğinde gösterilen alternatif metin.
     • message.contents (any): Flex mesajının içeriği. Bu, mesajın düzenini ve bileşenlerini tanımlayan bir JSON nesnesidir.
     • message.contents.type (enum): Konteyner türü. Tek konteyner için 'bubble', birden fazla kaydırılabilir bubble için 'carousel'.

5. get_profile

   • Görünen ad, profil resmi URL'si, durum mesajı ve dil dahil olmak üzere bir LINE kullanıcısının ayrıntılı profil bilgilerini alın.
   • Girdiler:
     • userId (string?): Profilini almak istediğiniz kullanıcının ID'si. Varsayılan olarak DESTINATION_USER_ID'dir.

6. get_message_quota

   • LINE Resmi Hesabının mesaj kotasını ve kullanımını alın. Bu, aylık mesaj limitini ve mevcut kullanımı gösterir.
   • Girdiler:
     • Yok

7. get_rich_menu_list

   • LINE Resmi Hesabınızla ilişkilendirilen rich menü listesini alın.
   • Girdiler:
     • Yok

8. delete_rich_menu

   • LINE Resmi Hesabınızdan bir rich menüyü silin.
   • Girdiler:
     • richMenuId (string): Silinecek rich menünün ID'si.

9. set_rich_menu_default

   • Bir rich menüyü varsayılan rich menü olarak ayarlayın.
   • Girdiler:
     • richMenuId (string): Varsayılan olarak ayarlanacak rich menünün ID'si.

10. cancel_rich_menu_default

    • Varsayılan rich menüyü iptal edin.
    • Girdiler:
      • Yok

11. create_rich_menu

    • Verilen aksiyonlara dayalı bir rich menü oluşturun. Bir görüntü oluşturun ve yükleyin. Varsayılan olarak ayarlayın.
    • Girdiler:
      • chatBarText (string): Sohbet çubuğunda görüntülenen metin, aynı zamanda rich menü adı olarak kullanılır.
      • actions (array): Rich menünün aksiyonları. Minimum 1 ile maksimum 6 aksiyon belirtebilirsiniz. Her aksiyon aşağıdaki türlerden biri olabilir:
        • postback: Postback aksiyonu göndermek için
        • message: Metin mesajı göndermek için
        • uri: Bir URL açmak için
        • datetimepicker: Tarih/saat seçici açmak için
        • camera: Kamerayı açmak için
        • cameraRoll: Kamera rulosunu açmak için
        • location: Mevcut konumu göndermek için
        • richmenuswitch: Başka bir rich menüye geçmek için
        • clipboard: Metni panoya kopyalamak için

12. get_follower_ids

    • LINE Resmi Hesabını arkadaş olarak ekleyen kullanıcıların kullanıcı ID'lerinin listesini alın. Bu, manuel olarak hazırlamadan mesaj göndermek için kullanıcı ID'leri elde etmenizi sağlar.
    • Girdiler:
      • start (string?): Sonraki kullanıcı ID'leri dizisini almak için devam jetonu. Önceki yanıtın next özelliğinde döndürülür.
      • limit (number?): Tek bir istekte alınacak maksimum kullanıcı ID'si sayısı.

Kurulum (npx Kullanarak)

gereksinimler:

• Node.js v22 veya üstü

Adım 1: LINE Resmi Hesabı Oluşturun

Bu MCP sunucusu bir LINE Resmi Hesabı kullanır. Eğer hesabınız yoksa, lütfen bu talimatları izleyerek oluşturun.

Eğer zaten bir LINE Resmi Hesabınız varsa, lütfen bu talimatları izleyerek LINE Resmi Hesabınız için Messaging API'sini etkinleştirin.

Adım 2: AI Ajanını Yapılandırın

Lütfen Claude Desktop veya Cline gibi bir AI Ajanj için aşağıdaki konfigürasyonu ekleyin.

Ortam değişkenlerini veya argümanları şu şekilde ayarlayın:

• CHANNEL_ACCESS_TOKEN: (gerekli) Channel Access Token. Bunu bu talimatları izleyerek doğrulayabilirsiniz.
• DESTINATION_USER_ID: (isteğe bağlı) Alıcının varsayılan kullanıcı ID'si. Eğer Tool'ün girdisi userId içermiyorsa, DESTINATION_USER_ID gereklidir. Bunu bu talimatları izleyerek doğrulayabilirsiniz.

{
  "mcpServers": {
    "line-bot": {
      "command": "npx",
      "args": [
        "@line/line-bot-mcp-server"
      ],
      "env": {
        "NPM_CONFIG_IGNORE_SCRIPTS": "true",
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

Kurulum (Docker Kullanarak)

Adım 1: LINE Resmi Hesabı Oluşturun

Bu MCP sunucusu bir LINE Resmi Hesabı kullanır. Eğer hesabınız yoksa, lütfen bu talimatları izleyerek oluşturun.

Eğer zaten bir LINE Resmi Hesabınız varsa, lütfen bu talimatları izleyerek LINE Resmi Hesabınız için Messaging API'sini etkinleştirin.

Adım 2: line-bot-mcp-server görüntüsünü oluşturun

Bu depoyu klonlayın:

git clone git@github.com:line/line-bot-mcp-server.git

Docker görüntüsünü oluşturun:

docker build -t line/line-bot-mcp-server .

Adım 3: AI Ajanını Yapılandırın

Lütfen Claude Desktop veya Cline gibi bir AI Ajanj için aşağıdaki konfigürasyonu ekleyin.

Ortam değişkenlerini veya argümanları şu şekilde ayarlayın:

• mcpServers.args: (gerekli) line-bot-mcp-server yolu.
• CHANNEL_ACCESS_TOKEN: (gerekli) Channel Access Token. Bunu bu talimatları izleyerek doğrulayabilirsiniz.
• DESTINATION_USER_ID: (isteğe bağlı) Alıcının varsayılan kullanıcı ID'si. Eğer Tool'ün girdisi userId içermiyorsa, DESTINATION_USER_ID gereklidir. Bunu bu talimatları izleyerek doğrulayabilirsiniz.

{
  "mcpServers": {
    "line-bot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CHANNEL_ACCESS_TOKEN",
        "-e",
        "DESTINATION_USER_ID",
        "line/line-bot-mcp-server"
      ],
      "env": {
        "CHANNEL_ACCESS_TOKEN" : "FILL_HERE",
        "DESTINATION_USER_ID" : "FILL_HERE"
      }
    }
  }
}

İnceleme ile Yerel Geliştirme

Sunucuyu yerel olarak test etmek ve hata ayıklamak için MCP Inspector'ı kullanabilirsiniz.

Ön Koşullar

1. Depoyu klonlayın:

git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server

2. Bağımlılıkları yükleyin:

npm install

3. Projeyi oluşturun:

npm run build

Inspector'ı Çalıştırın

Projeyi oluşturduktan sonra, MCP Inspector'ı başlatabilirsiniz:

npx @modelcontextprotocol/inspector node dist/index.js \
  -e CHANNEL_ACCESS_TOKEN="YOUR_CHANNEL_ACCESS_TOKEN" \
  -e DESTINATION_USER_ID="YOUR_DESTINATION_USER_ID"

Bu, LINE Bot MCP Server araçlarıyla etkileşim kurabileceğiniz ve işlevselliklerini test edebileceğiniz MCP Inspector arayüzünü başlatacaktır.

Sürüm Oluşturma

Bu proje anlamsal sürüm oluşturmaya saygı gösterir

Bkz. http://semver.org/

Katkıda Bulunma

Katkı sağlamadan önce lütfen CONTRIBUTING dosyasını kontrol edin.