Ollama MCP

🚀 Ollama MCP サーバー

Ollama 用の MCP（モデルコンテキストプロトコル）サーバーです。これにより、Ollama のローカル LLM モデルを MCP 対応のアプリケーション（Claude Desktop など）とシームレスに統合できます。

✨ 主な機能

• 利用可能な Ollama モデルを一覧表示
• 新しい Ollama モデルを取得
• Ollama のチャット API を使用してモデルと対話
• 詳細なモデル情報を取得
• 自動ポート管理
• 環境変数による設定

📦 インストール

手動インストール

npm を使用してグローバルにインストールします。

npm install -g @rawveg/ollama-mcp

他の MCP アプリケーションでのインストール

他の MCP 対応アプリケーション（Cline や Claude Desktop など）で Ollama MCP サーバーをインストールするには、アプリケーションの MCP 設定ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "@rawveg/ollama-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rawveg/ollama-mcp"
      ]
    }
  }
}

設定ファイルの場所はアプリケーションによって異なります。

• Claude Desktop：Claude アプリケーションデータディレクトリ内の claude_desktop_config.json
• Cline：VS Code のグローバルストレージ内の cline_mcp_settings.json

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

ollama-mcp

サーバーはデフォルトでポート 3456 で起動します。環境変数を使用して別のポートを指定することもできます。

PORT=3457 ollama-mcp

高度な使用法

環境変数の設定

• PORT：サーバーのポート（デフォルト：3456）。直接実行時に使用できます。

  # 直接実行時
  PORT=3457 ollama-mcp
  

• OLLAMA_API：Ollama API エンドポイント（デフォルト：http://localhost:11434）

API エンドポイント

• GET /models - 利用可能なモデルを一覧表示
• POST /models/pull - 新しいモデルを取得
• POST /chat - モデルと対話
• GET /models/:name - モデルの詳細情報を取得

📚 ドキュメント

開発手順

1. リポジトリをクローンします。

git clone https://github.com/rawveg/ollama-mcp.git
cd ollama-mcp

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

4. サーバーを起動します。

npm start

貢献方法

貢献を歓迎します！自由に Pull Request を送信してください。

ただし、事前に議論して合意が得られない限り、このプロジェクトをサードパーティのサービスや商用プラットフォームに統合する権限は与えられません。以前は Smithery との統合をサポートするために貢献（Dockerfile や関連する README の更新など）を受け入れていましたが、最近の Glama の行為により、このポリシーを見直すことにしました。

Glama は、事前の通知や同意なしにオープンソースの MCP プロジェクトを商用製品に組み込み、その後、メンテナに無償で作業を依頼する問題を作成して、その プラットフォームとの互換性を確保しました。このような行為 - 報酬を与えずにコミュニティの労力を利用して利益を得ること - は失礼なだけでなく、倫理的に受け入れられません。

したがって、貢献者の権利とプロジェクトの持続可能性を保護するために、このプロジェクトを MIT ライセンスから AGPL - 3.0 またはそれ以上のライセンスに変更することにしました。この変更により、このプロジェクトに依存して商用製品やサービスを構築するすべての会社は、コミュニティに対して透明性を持ち、利益を共有する必要があります。

貢献ガイドライン

このプロジェクトに貢献したい場合は、以下の手順を参考にしてください。

1. 問題の報告：問題が発生した場合や質問がある場合は、GitHub リポジトリに issue を投稿してください。
2. エラーの修正：興味のあるエラーや機能の欠如を見つけたら、Pull Request を送信して解決を試みてください。
3. 機能の追加：新しい機能のアイデアがある場合は、まず議論（issue または PR を通じて）して、プロジェクトの全体的な方向に合致することを確認してください。
4. ドキュメントの改善：ドキュメントはプロジェクトの重要な部分であり、改善提案は歓迎されます。

📄 ライセンス

このプロジェクトは AGPL - 3.0 ライセンスの下で保護されています。