Simple MCP Server

TypeScript作成MCPModel Context ProtocolClaudeDesktop使用操作情報取得可能

機能

MCP制限機能組込安全許可

許可

• Documents/00_AI_Area現在設定
• 他設定可能

• /etc``/bin``/Windows``/Program Files
• 機密情報.ssh``.aws``.config

許可拡張子

.txt, .md, .json, .js, .ts, .html, .css, .py, .java, .cpp, .c, .h, .xml, .yaml, .yml, .log, .csv, .tsv, .sql, .sh, .bat, .ps1

機能

• read_file: 読込許可
• write_file: 書込許可
• list_directory: 一覧表示許可
• get_system_info: 情報取得
• create_sample_file: 作成用
• get_allowed_paths: 可能一覧表示新機能

1. 依存関係

npm install

2.

npm run build

3. ClaudeDesktop設定

ClaudeDesktop設定通常 %APPDATA%\Claude\claude_desktop_config.json編集

{
  "mcpServers": {
    "simple-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {}
    }
  }
}

重要: args 配列 dist/index.js 絶対指定

4. ClaudeDesktop再起動

設定反映ClaudeDesktop再起動

開発

開発中以下直接実行

npm run dev

使用例

ClaudeDesktop以下試

情報取得

情報教

可能確認

可能一覧表示

作成

test.txt名前作成

読込

test.txt内容読込

一覧表示

現在一覧表示

書込

hello.txtHello, MCP World!書込

設定

PathValidator設定変更許可

// 許可追加
this.allowedPaths = [
  path.resolve(os.homedir(), 'Documents/00_AI_Area'),
  // 追加
  path.resolve('/path/to/your/allowed/directory'),
];

// 許可拡張子追加
this.allowedExtensions = [
  '.txt', '.md', '.json',
  // 新拡張子追加
  '.custom',
];

構成

simple-mcp-server/
 src/
    index.ts          # 実装
 dist/                 # 後JavaScript
 package.json          # 設定
 tsconfig.json         # TypeScript設定
 README.md            # 

MCP認識場合

1. ClaudeDesktop設定正確認
2. dist/index.js 絶対正確認
3. npm run build 正常完了確認
4. ClaudeDesktop完全再起動

操作発生場合

• 存在確認
• 適切読書権限確認
• 相対絶対使用

関連

"許可"

• 許可内
• get_allowed_paths使用可能確認

"許可拡張子"

• 拡張子
• 許可拡張子一覧確認必要応設定変更

動作標準出力出力

npm run dev 2> debug.log

新追加

1. TOOLS 配列新定義追加
2. setupToolHandlers() 追加
3. 対応実装

例現在時刻取得追加場合get_current_time 実装

考慮事項

• 制限: 機密情報不正防止
• 拡張子: 実行可能危険形式
• 正規化: 相対..使親不正防止
• ****: 適切違反通知

質問

Q: 新場合

A: 配列追加再起動 PathValidator``allowedPaths

Q: 制限無効

A: 上推奨常{ isValid: true, normalizedPath }返変更 validatePath

Q: 大処理可能

A: 現在実装全体読込非常大処理適

注意事項

• 学習目的作成
• 本番環境使用場合適切対策追加
• 操作実行権限行
• 制限許可以外

厳重注意: 環境使用想定本番環境使用場合追加対策検討

MIT License